Preguntas frecuentes
¿Qué es una API de texto a voz?
Es un servicio en la nube que convierte texto en archivos de audio mediante una solicitud HTTP POST. Envías texto y recibes el audio generado, sin necesidad de instalar motores complejos en el dispositivo.
¿Por qué usar una API en lugar de un SDK?
Usar una API REST permite integrar voces naturales sin dependencias externas ni SDKs específicos de la plataforma. Solo necesitas realizar solicitudes HTTP, lo que simplifica la integración en equipos que priorizan la velocidad y el control de costos.
¿Cómo se elige la voz correcta?
Selecciona entre ocho presets disponibles en el endpoint /v1/voices. Elige según el tono: Aria para narración, Nova para entusiasmo, Luna para historias o Atlas para noticias, asegurando que coincida con el estilo de tu aplicación móvil.
¿Qué es la velocidad de voz?
Es un parámetro ajustable entre 0.25 y 4.0 que modifica la velocidad de lectura del texto. Permite acelerar o ralentizar la síntesis para adaptarse al ritmo de la experiencia de usuario en tu aplicación móvil.
¿Se puede pausar la síntesis?
No existe streaming ni WebSocket para pausar la generación en tiempo real. La síntesis se procesa de forma síncrona; debes esperar a recibir el archivo completo antes de reproducirlo o gestionarlo en tu aplicación.
¿Cuánto tarda en generarse el audio?
Típicamente tarda lo mismo que la duración del audio (unos 25 caracteres por segundo). Frases cortas tardan unos segundos; bajo carga, las solicitudes pueden esperar en cola antes de procesarse.
¿Se puede usar en segundo plano?
Sí, la API es asíncrona. Tu aplicación puede enviar la solicitud y continuar su ejecución, recibiendo el archivo de audio cuando esté listo. No bloquea la interfaz de usuario durante la generación.
¿Qué es un formato OPUS?
Es uno de los formatos de audio soportados para la respuesta. Ofrece una buena relación entre calidad y tamaño de archivo, ideal para optimizar el uso de datos móviles en tus aplicaciones.
¿Cómo se maneja el idioma automáticamente?
El sistema intenta adivinar el idioma desde el script del texto. Para textos en latín no ingleses, se recomienda establecer el parámetro 'language' explícitamente para evitar errores de pronunciación en la síntesis.
¿Se puede cambiar la voz después de generar?
No, cada solicitud genera un archivo de audio único con la voz especificada. Para cambiar la voz, debes enviar una nueva solicitud con el parámetro 'voice' diferente y recibir un nuevo archivo.
¿Qué es el modelo tts-1-hd?
Es un modelo de alta definición disponible en la API. Utiliza el mismo motor que tts-1 y tiene el mismo precio por carácter.
¿Se puede transmitir audio en tiempo real?
No. La API devuelve el archivo completo al finalizar la solicitud. No hay streaming de audio ni WebSocket para recibir fragmentos parciales.
¿Cómo se almacena el audio generado?
El audio se devuelve en la respuesta y no se almacena en nuestros servidores. Solo se guardan metadatos de la solicitud (tiempo, caracteres, estado) para fines de facturación y control de uso.
¿Es necesario un servidor para la API?
No, es una API REST directa. Puedes realizar solicitudes POST desde tu aplicación móvil o backend sin necesidad de un servidor intermediario propio, aunque se recomienda gestionar la clave API de forma segura.
El flujo de solicitud
La integración comienza enviando el texto al endpoint POST https://api.playak444.com/v1/audio/speech mediante una solicitud HTTP con cuerpo JSON. Este flujo es compatible con SDKs estándar como los de OpenAI, solo requiriendo ajustar la base_url y autenticar con la clave Bearer.
El servidor procesa la síntesis de voz en la nube y devuelve directamente el archivo de audio generado. No se requiere streaming ni conexión WebSocket; el archivo completo está disponible inmediatamente tras completar la solicitud.
Envío del texto al endpoint
La aplicación móvil construye una petición POST a https://api.playak444.com/v1/audio/speech. El cuerpo debe incluir el campo input con el texto a convertir (máximo 4096 caracteres), el model ("tts-1" o "tts-1-hd"), y el voice deseado. La autenticación se realiza con el encabezado Authorization: Bearer tts-....
- Endpoint: POST /v1/audio/speech
- Autenticación: Header Bearer token
- Formato: JSON
Procesamiento en la nube
El servicio genera el audio utilizando motores de voz naturales. La velocidad de generación es aproximadamente de 25 caracteres por segundo para textos largos, aunque frases cortas pueden tardar unos segundos adicionales. Las solicitudes se procesan en secuencia, por lo que bajo alta carga pueden entrar en cola.
- Procesamiento secuencial
- Velocidad ~25 chars/seg
- Sin streaming
Recarga del archivo de audio
La respuesta contiene el archivo de audio binario en el formato solicitado (mp3, wav, opus, flac, pcm). La aplicación móvil debe guardar este archivo temporalmente o reproducirlo directamente desde la memoria. El archivo no se almacena en los servidores de VozFlujo tras la entrega.
- Formatos: mp3, wav, opus, flac, pcm
- Respuesta binaria directa
- Sin almacenamiento persistente en servidor
Configuración del cliente
La integración en aplicaciones móviles se basa en el SDK de OpenAI o HTTP directo, ya que no ofrecemos un SDK propio. Solo requiere configurar la base URL y la clave de autenticación para enviar texto y recibir audio.
Este enfoque mínimo reduce la dependencia de bibliotecas externas y permite un control directo sobre la gestión de memoria y el buffering en el dispositivo, priorizando la velocidad de integración.
Instalación del SDK HTTP
Instale el paquete estándar de HTTP o el SDK de OpenAI en su entorno de desarrollo móvil. No es necesario descargar una librería específica de VozFlujo, ya que la API es compatible con las herramientas estándar de la industria.
- Compatible con iOS y Android
- Sin dependencias nativas complejas
- Uso de librerías HTTP estándar
Configuración de la clave API
Genere su clave en /get-api-key/ usando Google o correo electrónico. Asigne la variable Authorization: Bearer tts-... en el cliente móvil. Cada cuenta tiene una clave activa que se invalida al emitir una nueva.
- Clave única por cuenta
- Invalidación inmediata al renovar
- Autenticación Bearer estándar
Establecimiento de la base_url
Configure la URL base en https://api.playak444.com/v1 dentro de la configuración del cliente HTTP. Esto permite reutilizar la lógica de peticiones existente sin modificar la estructura de las llamadas a la API.
- URL base: api.playak444.com/v1
- Estructura compatible con OpenAI
- Configuración única por entorno
Parámetros de entrada
Los parámetros de entrada definen cómo se sintetiza y entrega el audio. La selección de la voz determina el tono narrativo, mientras que el formato y la velocidad ajustan la compatibilidad del dispositivo y el ritmo de la lectura para optimizar el rendimiento en aplicaciones móviles.
Selección de la voz
Elige entre ocho presets que cubren estilos desde narradores cálidos hasta voces documentales profundas. Cada voz puede hablar cualquiera de los 23 idiomas disponibles, lo que permite mantener la consistencia vocal sin importar el idioma del texto fuente.
- Aria: narradora clara y cálida
- Atlas: neutral, ideal para noticias
- Orion: profunda, para documentales
- Soporta todos los 23 idiomas listados
Definición del formato
Selecciona el formato de salida (mp3, wav, opus, flac o pcm) según la eficiencia de almacenamiento y la compatibilidad del reproductor de tu app. El formato mp3 es eficiente en tamaño, mientras que wav o flac ofrecen mayor fidelidad si el ancho de banda no es una limitante crítica.
- Opciones: mp3, wav, opus, flac, pcm
- Opus para balance calidad/tamaño
- WAV para máxima fidelidad
Ajuste de velocidad
Ajusta la velocidad de reproducción entre 0.25 y 4.0 para adaptar el ritmo a la experiencia de usuario. Velocidades más altas reducen el tiempo de generación y el consumo de datos, mientras que velocidades más bajas mejoran la comprensión en contenido educativo o técnico.
- Rango permitido: 0.25 a 4.0
- Velocidad 1.0 es el estándar
- Ajusta según la complejidad del texto
Manejo de textos largos
La API TTS de VozFlujo tiene un límite estricto de 4096 caracteres por solicitud. Para aplicaciones móviles que generan narraciones más extensas, es necesario dividir el texto en fragmentos manejables antes de enviarlos al endpoint.
Este enfoque garantiza que cada parte se sintetice correctamente sin cortes inesperados, manteniendo la coherencia del audio final.
División en fragmentos
Antes de realizar la llamada POST, el cliente móvil debe segmentar la entrada en bloques de máximo 4096 caracteres. Cada fragmento se envía como un cuerpo JSON independiente.
Es crucial contar los caracteres incluyendo espacios y puntuación, ya que cada uno cuenta para el límite y el costo.
Generación secuencial
Las peticiones se procesan una tras otra en la cola del servidor. Aunque la velocidad es cercana al tiempo real, los fragmentos pequeños pueden tardar unos segundos en generarse.
El cliente debe esperar a que cada solicitud complete su estado antes de solicitar el siguiente fragmento, evitando saturar los límites de velocidad.
Unión de archivos de audio
Una vez recibidos los archivos de audio de cada fragmento, la aplicación debe concatenarlos en orden cronológico. El formato seleccionado (mp3, wav, etc.) debe ser consistente en todas las partes.
Esta unión ocurre localmente en el dispositivo, permitiendo una reproducción fluida sin interrupciones perceptibles entre los segmentos generados.
Reproducción en el dispositivo
La reproducción fluida depende de cargar el audio sin bloquear la interfaz. Al recibir el archivo, almacénlo en memoria temporal para iniciar la reproducción inmediatamente.
Gestione la liberación de recursos después de cada reproducción. Esto evita que la aplicación consuma memoria excesiva durante el uso prolongado.
Buffering de audio
Descargue el archivo completo antes de iniciar la reproducción para evitar interrupciones. Esto es crucial en redes móviles inestables.
Utilice buffers de tamaño moderado para equilibrar la latencia inicial y la estabilidad del flujo de audio.
- Pre-cargar el audio en segundo plano
- Evitar pausas durante la reproducción
- Manejar cortes de red sin detener la app
Gestión de memoria
Limpie los archivos temporales después de reproducirlos. Esto es importante en dispositivos con recursos limitados.
Monitoree el uso de memoria para evitar cierres inesperados de la aplicación durante sesiones largas.
- Liberar memoria tras cada reproducción
- Evitar fugas de memoria en bucles
- Monitorear el consumo de RAM
Controles de reproducción
Proporcione controles básicos como reproducir, pausar y detener. Esto mejora la experiencia del usuario.
Asegúrese de que los controles respondan inmediatamente a las interacciones del usuario.
- Reproducir y pausar
- Detener la reproducción
- Saltar a puntos específicos
Optimización de costos
Controlar el gasto por carácter es clave en apps móviles. Implementar caché de respuestas para frases frecuentes reduce solicitudes redundantes y optimiza el saldo disponible.
Seleccionar formatos eficientes como opus o mp3 minimiza el tamaño de archivo sin sacrificar calidad audible, asegurando que cada carácter consumido tenga un impacto directo en la experiencia del usuario.
Caché de respuestas comunes
Almacena localmente los resultados de texto corto o frases estáticas. Esto evita nuevas llamadas a la API para contenido inmutable, conservando el crédito.
Invalide la caché solo cuando cambie la voz o la velocidad. Revise el saldo regularmente para ajustar la estrategia de almacenamiento según el uso.
- Guardar hashes de texto para búsquedas rápidas
- Actualizar caché ante cambios de voz
- Monitorear hits de caché vs. peticiones
Compresión de audio
El precio es por carácter generado, no por bytes descargados, pero formatos como opus o mp3 reducen el uso de datos móviles del usuario.
Use FLAC solo si necesita pérdida cero. Para la mayoría de casos, mp3 u opus ofrecen una buena relación calidad-tamaño sin afectar la facturación.
- Usar opus para móviles
- Evitar WAV sin necesidad
- Comprobar compatibilidad del reproductor
Generación bajo demanda
Genere audio solo cuando el usuario lo solicite explícitamente. Evite pre-generar grandes volúmenes de texto que no se reproducirán, pagando caracteres innecesarios.
Combine la generación bajo demanda con la caché de respuestas comunes para maximizar la eficiencia de cada solicitud enviada al endpoint.
- Evitar pre-generación masiva
- Solicitar solo en interacción activa
- Validar texto antes de enviar
Validación de datos
La validación de datos es el primer filtro antes de enviar texto a la API. En aplicaciones móviles, los caracteres especiales o longitud excesiva generan errores inmediatos que consumen créditos sin producir audio. Validar localmente ahorra tiempo de red y dinero.
El límite estricto de 4096 caracteres por solicitud debe verificarse antes del envío. Si el texto excede este valor, se debe dividir o truncar. Esto previene respuestas 4xx que no devuelven audio.
Verificación de longitud
Cada solicitud POST acepta un máximo de 4096 caracteres. Este límite incluye espacios y puntuación. Excederlo provoca un error de validación inmediato.
- Contar caracteres antes de formar el JSON.
- Usar la función nativa del lenguaje móvil (
lengthocount). - Considerar que caracteres Unicode pueden contar como más de uno en algunos lenguajes.
Codificación de caracteres
La API espera texto UTF-8. Asegúrate de que tu aplicación envíe la carga útil en este formato. Caracteres no soportados en los 23 idiomas listados pueden causar fallos silenciosos o audio defectuoso.
- Forzar UTF-8 en las cabeceras HTTP.
- Verificar que emojis o símbolos raros no rompan la serialización JSON.
- Compatible con los idiomas disponibles: inglés, español, japonés, etc.
Validación de formato
El cuerpo de la solicitud debe ser un objeto JSON válido con las claves model, input, voice y response_format. Campos faltantes o tipos incorrectos (ej. input como número) devuelven error 400.
- Usar un cliente HTTP con serialización JSON automática.
- Validar que
voicesea uno de los 8 presets. - Verificar que
response_formatsea mp3, wav, opus, flac o pcm.

Manejo de errores comunes
Los errores de integración suelen estar relacionados con la gestión de la clave API, el saldo de la cuenta o los límites de velocidad. Conocer las causas comunes permite resolverlos rápidamente sin detener el flujo de la aplicación móvil.
Expiración de clave API
Cada cuenta tiene una clave activa. Si emites una nueva, la anterior deja de funcionar inmediatamente. Asegúrate de actualizar la variable de entorno en tu app para evitar fallos de autenticación.
Saldo insuficiente
Si el balance es cero, las solicitudes fallan. No hay cargos pendientes ni suscripciones. Recarga mediante USDT (TRC-20) para reanudar el servicio instantáneamente.
Límite de velocidad alcanzado
El límite es de 60 solicitudes por minuto por clave. Si excedes este umbral, las peticiones se rechazarán. Implementa lógica de reintento con backoff exponencial en tu cliente móvil para manejar picos de demanda.
Pruebas en entorno local
Antes de integrar la API en tu aplicación móvil, valida el funcionamiento básico utilizando el crédito de prueba inicial. Este crédito de $0.50 permite generar aproximadamente 50 000 caracteres y es válido durante 7 días tras el inicio de sesión con Google. Es ideal para verificar la calidad de las voces sin comprometer tu saldo principal.
Realiza solicitudes de prueba con textos cortos para confirmar que la integración responde correctamente. Asegúrate de que los archivos de audio se generen en los formatos esperados y que la latencia sea aceptable para tu caso de uso específico.
Uso del crédito de prueba
El crédito de prueba se asigna automáticamente al registrarte con Google, ofreciendo $0.50 equivalentes a unos 50 000 caracteres. Este saldo es válido durante 7 días y permite probar la API sin riesgo financiero. Si te registras con email y contraseña, no recibirás este crédito inicial.
Utiliza este saldo para ejecutar pruebas básicas de integración. Verifica que la autenticación con la clave API funcione y que las respuestas sean correctas antes de iniciar el desarrollo de la lógica de reproducción en tu app.
- Crédito de $0.50 para ~50 000 caracteres.
- Válido por 7 días tras registro con Google.
- No requiere tarjeta de crédito ni suscripción.
Simulación de peticiones
Envía solicitudes POST al endpoint de la API con diferentes voces y formatos para evaluar el rendimiento. Usa herramientas como cURL o el SDK de OpenAI ajustando la base URL a https://api.playak444.com/v1. Prueba con textos en varios idiomas soportados para verificar la detección automática o la configuración explícita de language.
Verifica que la respuesta contenga el archivo de audio en el formato seleccionado (mp3, wav, opus, flac, pcm). Asegúrate de que la codificación de caracteres y la longitud del texto estén dentro de los límites permitidos para evitar errores silenciosos.
- Usa cURL o SDKs compatibles con la API.
- Prueba voces en diferentes idiomas soportados.
- Verifica formatos de salida y codificación.
Verificación de formatos
Confirma que el archivo de audio generado cumple con los estándares del formato seleccionado. Reproduce localmente los archivos para verificar la claridad del audio y la velocidad de reproducción ajustada. Asegúrate de que la API no devuelva errores de sintaxis en la respuesta JSON.
Revisa que los metadatos del archivo sean consistentes y que la duración del audio coincida con la longitud del texto ingresado. Esto es crucial para sincronizar correctamente la reproducción en la aplicación móvil.
- Verifica claridad y velocidad del audio.
- Confirma consistencia de metadatos JSON.
- Asegura sincronización con la duración del texto.
Despliegue en producción
Una vez validado el flujo, el despliegue en producción exige un monitoreo continuo del consumo de caracteres y el estado de la cuenta. La página de configuración muestra el saldo restante y los caracteres utilizados, permitiendo detectar desviaciones antes de que afecten la experiencia del usuario.
Monitoreo de uso
Revisa periódicamente el historial de uso en el panel. Dado que el costo es por carácter, un aumento inesperado en la métrica puede indicar un bucle de llamadas o un cambio en la longitud media del texto generado.
- Verificar el saldo restante antes de lanzar campañas masivas.
- Alinear el volumen de texto con el presupuesto disponible.
Gestión de claves
Mantén una única clave activa por cuenta. Si hay sospecha de compromiso o simplemente para rotar credenciales, emite una nueva clave desde el panel. La clave antigua deja de funcionar inmediatamente, evitando accesos no deseados.
- Emite una nueva clave para invalidar la anterior al instante.
- Almacena la clave en variables de entorno seguras en el servidor.
Ajuste de límites
Considera la limitación de 60 solicitudes por minuto por clave. Si tu aplicación móvil genera picos de demanda simultáneos, implementa lógica de cola en el cliente o divide la carga entre varias instancias si es viable, aunque la arquitectura recomienda una sola clave activa para simplificar la gestión.
Consideraciones de latencia
La latencia de la API depende del volumen de texto y la carga del servidor. Las frases cortas tardan unos segundos, mientras que textos largos se generan a un ritmo cercano al tiempo real.
Tiempo de respuesta promedio
El procesamiento es secuencial y consume aproximadamente 25 caracteres de texto por segundo de audio generado. Las frases breves tardan unos segundos en generarse.
Colas en momentos de carga
Las solicitudes se procesan en orden. Durante picos de demanda, una petición puede esperar en cola antes de comenzar la generación, incrementando el tiempo total de espera más allá del cálculo estándar.
Estrategias de pre-caching
Para minimizar la percepción de latencia en la aplicación móvil, genere y almacene localmente los audios de frases comunes o menús estáticos antes de que el usuario los necesite.
Soporte y escalabilidad
La escalabilidad de VozFlujo se basa en una estructura simple: no hay planes fijos ni límites de capacidad predefinidos. Puedes generar el volumen que tu aplicación requiera, pagando únicamente por los caracteres consumidos. Esto permite adaptar el uso directamente al crecimiento real de tu producto móvil sin penalizaciones por cuota.
Para gestionar picos de demanda, la arquitectura procesa las solicitudes secuencialmente. Si hay alta carga, las peticiones se ponen en cola y se ejecutan una tras otra. Esto garantiza que cada solicitud se complete correctamente sin perder datos, manteniendo la coherencia del audio generado incluso bajo presión.
Crecimiento del volumen
Al no existir planes de suscripción ni cupos fijos, tu capacidad de generación depende únicamente de tu saldo. A medida que tu aplicación crece, simplemente recargas tu cuenta con USDT (TRC-20) para continuar generando audio sin interrupciones ni cambios de plan.
- No hay límites superiores de volumen.
Gestión de picos de demanda
Las solicitudes se procesan en cola uno tras otro. En momentos de alta concurrencia, es posible que haya un ligero retraso, pero todas las peticiones se ejecutan sin pérdida de datos.
Comunicación por email
El soporte se realiza exclusivamente por correo electrónico. No hay chat en vivo ni teléfono. Esta vía permite registrar el historial de la consulta y es suficiente para resolver dudas técnicas sobre la API o estados de cuenta.
Escucha las 8 voces
Cada muestra a continuación fue generada por esta API a partir de la misma frase. Cada sitio opera de forma independiente, manteniendo tus credenciales aisladas del resto de la red.
23 idiomas
Cualquier voz puede hablar cualquiera de estos idiomas.
Fuentes y lecturas adicionales
- Wikipedia
- IETF RFC 7845: Ogg Opus
- ISO 639 language codes
- Tether (USDT)
- LibriTTS-R corpus (OpenSLR 141)
- LibriTTS-R paper (arXiv 2305.18802)
- FFmpeg documentation
- Creative Commons Attribution 4.0
- OpenAI API reference: create speech
- W3C WAI: making audio and video accessible
- MDN: Web Speech API
- openai-python on GitHub
