La API pública de Speechdash ya está disponible

La API pública de Speechdash ya está en api.speechdash.com/v1. Si construyes productos en los que hay que escuchar texto, puedes crear documentos y generar voz sin abrir la interfaz del navegador.

Este artículo resume qué incluye el lanzamiento, cómo funciona la facturación y cómo enviar tu primera petición en unos minutos.

Qué permite la API hoy

La API REST refleja la misma pila de escucha que ya conoces en la aplicación:

• Crear y gestionar documentos en la biblioteca Speechdash de un usuario (importación de texto con título e idioma)
• Generar voz con los presets Narrador, Preguntador y Experto en muchos idiomas
• Listar, leer, actualizar y eliminar documentos mediante endpoints JSON predecibles

Los documentos creados por la API aparecen en la biblioteca en speechdash.com. Tus usuarios pueden seguir escuchando en la app, editar el texto, exportar audio o continuar en otro dispositivo.

La síntesis usa las mismas voces en la nube que la reproducción en la app. El consumo se descuenta de la cartera de créditos de la cuenta, con las mismas reglas que la escucha en la nube del producto.

Para quién es

Los equipos recurren a la API cuando la escucha debe vivir dentro de otro producto:

• LMS y plataformas de estudio que quieren lectura en voz alta en tareas o artículos
• Capas de accesibilidad dentro de herramientas SaaS
• Herramientas internas que importan contenido en lote para revisarlo a oído
• Prototipos que necesitan una vista previa hablada antes de una interfaz completa

Si tus usuarios ya tienen cuenta en Speechdash, mantienen una sola cartera y una sola biblioteca. La API es una puerta de entrada más, no un producto aparte.

Autenticación y documentación

Cada cuenta crea claves de API en Configuración → API en speechdash.com/settings/api. La clave se muestra una sola vez; en el servidor solo se guarda un prefijo.

Envía Authorization: Bearer sh_live_… en cada petición. Una clave inválida o revocada devuelve 401.

La documentación para desarrolladores está en el centro de ayuda:

• Resumen de la API (autenticación, límites, facturación, idempotencia)
• Contrato OpenAPI en vivo en api.speechdash.com/v1/openapi.json

La página de producto API pública resume la propuesta para quien no programe en tu equipo.

Facturación en resumen

Las peticiones de voz retienen una estimación y luego ajustan la duración medida. En reintentos puedes enviar Idempotency-Key al crear documentos y al generar voz para evitar un doble cargo tras un fallo de red.

Los límites de tasa aplican por cuenta (no por clave). Las respuestas incluyen las cabeceras habituales y Retry-After cuando conviene esperar.

Primera petición en cinco minutos

1. Inicia sesión en speechdash.com y abre Configuración → API
2. Crea una clave y cópiala al momento
3. Lee el resumen de la API
4. Haz un POST con un texto breve a /v1/documents o llama a /v1/audio/speech con un preset de voz e idioma

Empieza con dos frases antes de procesar un capítulo entero. El resumen lista los campos exactos y ejemplos de respuesta.

Próximos pasos

Ampliaremos la API según evolucione el producto. Si integras ya, únete a Discord para comentarios tempranos o consulta el centro de ayuda si algo del contrato no está claro.

Gracias por construir con Speechdash. Tenemos ganas de ver qué publicas.

Guías relacionadas

• Página de la API pública
• Primeros pasos con Speechdash
• Reproducción en la nube
• Formatos de importación
• Qué consume créditos