Preguntas frecuentes
¿Qué significa API en el contexto de voz?
Es una interfaz de programación que permite a tu sistema enviar texto y recibir un archivo de audio mediante una llamada HTTP POST. Al usar el endpoint estándar, tus aplicaciones pueden integrar síntesis de voz de manera automatizada sin necesidad de interfaces gráficas, facilitando la integración con plataformas de call centers.
¿Cómo se diferencia de un generador web?
A diferencia de un generador web donde un usuario interactúa manualmente, una API permite que tu software envíe texto y reciba audio automáticamente. Esto es ideal para IVR, ya que puedes generar audio al vuelo en respuesta a eventos del sistema, sin intervención humana directa en la generación del archivo.
¿Qué es un sistema IVR?
Un Interactive Voice Response (IVR) es un sistema telefónico automatizado que permite a los clientes interactuar con una empresa a través de menús de voz o teclado. La API de VozRápida se integra en este flujo para leer opciones o mensajes personalizados cuando el usuario selecciona una opción del menú.
¿Para qué sirve la voz sintética en call centers?
Permite reproducir mensajes de bienvenida, menús de opciones y notificaciones de estado de llamadas de forma automática. Al usar una API, puedes actualizar los mensajes dinámicamente según la información del cliente o la campaña, manteniendo la coherencia y reduciendo los costos de producción de audio comparado con grabaciones humanas.
¿Qué es el texto a voz (TTS)?
Es la tecnología que convierte texto escrito en audio audible. Nuestra API recibe texto (hasta 4096 caracteres) y devuelve un archivo de audio generado por motores de síntesis. Es un servicio en la nube que no requiere instalación local, procesando las solicitudes mediante llamadas HTTP estándar.
¿Es una API o un software local?
Es una API en la nube. No necesitas instalar software en tus servidores. Solo envías una solicitud POST a nuestro endpoint con tu clave API y el texto. La respuesta contiene el archivo de audio, lo que simplifica la infraestructura y permite escobar el uso según la demanda sin gestionar servidores.
¿Qué formatos de audio son mejores para PBX?
Ofrecemos mp3, wav, opus, flac y pcm. Para PBX y sistemas IVR, wav o pcm son ideales por su compatibilidad nativa con la mayoría de las centrales telefónicas. El formato opus también es eficiente en ancho de banda. Elige el formato que tu central soporte nativamente para evitar conversiones.
¿Se puede personalizar la voz?
No ofrecemos clonación de voz personalizada ni subida de voces propias. Tienes 8 voces predefinidas (como Aria, Nova, Felix) que cubren distintos tonos. Puedes ajustar la velocidad entre 0.25 y 4.0, pero la voz base es fija. No hay etiquetas de emoción ni SSML disponible actualmente.
¿Cuántos idiomas soporta la API?
Soporta 23 idiomas, incluyendo español, inglés, alemán, francés, portugués, italiano, japonés, chino, árabe y ruso. Cualquier voz puede hablar cualquiera de estos idiomas. Si no especificas el idioma, el sistema intenta adivinarlo, pero para textos en latinos distintos al inglés, se recomienda establecer el campo language explícitamente.
¿Qué es la detección automática de idioma?
Si no envías el campo 'language', el sistema intenta inferirlo. El texto en latinos sin especificación se asume como inglés por defecto. Para textos en otros idiomas con alfabeto latino (como español o francés), debes indicar el código ISO del idioma para asegurar una pronunciación correcta y evitar errores.
¿Qué pasa si el texto es muy largo?
Cada solicitud acepta hasta 4096 caracteres. Si tu texto es más largo, debes dividirlo en partes de ese tamaño y unir los archivos de audio resultantes. La API procesa las solicitudes secuencialmente, por lo que textos muy largos pueden tardar más debido a la cola de procesamiento.
¿Es necesario contratar a un desarrollador?
Para una integración completa con IVR, se requiere conocimiento técnico para manejar las llamadas HTTP y la lógica de división de texto. Sin embargo, la API es compatible con el formato de solicitud de OpenAI, por lo que puedes usar los SDKs oficiales de OpenAI cambiando la base URL o curl. Si tu equipo tiene capacidad básica de integración, no necesitas un desarrollador dedicado exclusivamente a esto.
¿Se puede usar en sistemas legacy?
Sí, ya que la comunicación es mediante HTTP POST y JSON, compatible con cualquier sistema que pueda hacer llamadas web. Puedes generar el audio por adelantado o en tiempo real. Solo necesitas gestionar la clave API y el formato de audio que tu sistema legacy pueda reproducir, como WAV o PCM.
¿Qué es una marca de agua en audio?
Cada archivo generado contiene una marca de agua inaudible que identifica el audio como voz sintética generada por nuestra API. Esto sirve para propósitos de identificación y verificación, permitiendo distinguir el audio generado automáticamente del grabado por humanos sin afectar la experiencia auditiva del usuario final.
Definición de API TTS
La API de VozRápida es un servicio de síntesis de voz en la nube que convierte texto en audio mediante una interfaz programática estándar. Permite la generación de audio bajo demanda, ideal para integrar voz en sistemas de respuesta interactiva (IVR) sin infraestructura compleja.
Servicio de síntesis de voz
El servicio toma texto como entrada y devuelve un archivo de audio listo para reproducirse. No requiere instalación de software local ni gestión de motores de TTS internos.
Interfaz programática
La integración se realiza mediante una llamada HTTP POST al endpoint /v1/audio/speech. El formato de solicitud es idéntico al de la API de OpenAI, facilitando la conexión con sistemas IVR existentes mediante cualquier lenguaje de programación que soporte JSON.
Generación bajo demanda
El audio se genera exclusivamente cuando se solicita, permitiendo respuestas dinámicas basadas en datos en tiempo real del usuario o del sistema. No es necesario almacenar archivos de voz pregrabados para cada posible combinación de mensajes.
Aplicación en sistemas IVR
La API TTS de VozRápida transforma menús IVR estáticos en experiencias dinámicas. Al generar audio bajo demanda, los sistemas de respuesta de voz interactiva pueden actualizar instantáneamente precios, horarios o nombres de agentes sin depender de archivos pregrabados.
Esta capacidad permite personalizar la experiencia por usuario. El sistema puede insertar nombres propios, números de cuenta o códigos de seguimiento directamente en el texto antes de la síntesis, manteniendo un flujo natural y coherente en cada interacción.
Menús de navegación automática
Reemplace archivos de audio fijos con generación en tiempo real. La API acepta texto y devuelve el audio, permitiendo menús que se adaptan a cambios operativos sin intervención técnica.
- Actualización instantánea de opciones de menú
- Sin gestión de archivos MP3/WAV
- Consistencia acústica en toda la extensión
Respuestas a preguntas frecuentes
Integre respuestas contextuales directamente en el flujo de llamada. El texto generado puede incluir variables específicas del cliente, como el estado de un pedido o el tiempo de espera actual en la cola.
- Inserción de variables en tiempo real
- Respuestas precisas y actualizadas
- Reducción de grabaciones redundantes
Notificaciones de estado
Mantenga a los usuarios informados con notificaciones dinámicas. Desde actualizaciones de servicio hasta confirmaciones de transacciones, el audio se genera al momento, asegurando que la información sea siempre vigente.
- Notificaciones personalizadas por llamada
- Información financiera o logística exacta
- Generación bajo demanda
Ventajas sobre archivos estáticos
La API TTS permite generar audio bajo demanda, eliminando la necesidad de almacenar miles de archivos estáticos en servidores IVR. Cada llamada puede crear contenido único en tiempo real, adaptándose a cambios dinámicos sin intervención manual.
Contenido dinámico y actualizable
Los textos se sintetizan al momento de la solicitud, lo que permite actualizar información crítica (precios, estados de servicio) instantáneamente. No hay latencia de propagación ni necesidad de regenerar y redistribuir archivos MP3/WAV pregrabados a todos los nodos del PBX.
Reducción de almacenamiento
Al generar audio bajo demanda, se elimina la necesidad de mantener una biblioteca masiva de archivos de voz. Esto reduce el espacio de almacenamiento en el servidor y simplifica la gestión de recursos en sistemas de call centers con alto volumen de llamadas.
Personalización por usuario
La API permite incluir variables en el texto (como el nombre del cliente o el número de pedido) directamente en la solicitud. Esto facilita la creación de experiencias de voz únicas para cada interacción sin necesidad de pregrabar todas las combinaciones posibles.
Integración técnica
La integración se realiza mediante solicitudes HTTP POST al endpoint /v1/audio/speech. Se envía texto en formato JSON y se recibe directamente el archivo de audio generado, sin necesidad de middleware complejo.
Llamadas HTTP POST
Envía texto y parámetros como voz o velocidad en el cuerpo de la solicitud. La API procesa la solicitud y retorna el audio sintético.
- Endpoint: POST https://api.tk999us.info/v1/audio/speech
- Cuerpo: JSON con 'input', 'voice', 'model'
- Autenticación: Header 'Authorization: Bearer tts-...'
Respuesta con archivo audio
La respuesta contiene el archivo de audio binario en el formato solicitado (mp3, wav, opus, flac o pcm). No se requiere almacenamiento previo del audio.
Protocolos estándar
Utiliza HTTP/HTTPS estándar, compatible con cualquier lenguaje de programación que soporte REST. Ideal para integrar en sistemas IVR existentes sin modificaciones profundas.
Calidad de voz sintética
VozRápida ofrece ocho voces predefinidas basadas en grabaciones con licencia, como Aria o Felix. Estas voces evitan la robótica excesiva típica de los sistemas IVR antiguos, proporcionando una experiencia de usuario más fluida y profesional en las llamadas automatizadas.
Voces naturales predefinidas
Cada voz tiene un tono distintivo, desde narradoras claras hasta voces documentales profundas. Esto permite seleccionar la personalidad adecuada para cada tipo de llamada sin necesidad de generar contenido nuevo.
- Aria: narradora clara y cálida
- Felix: energético para promociones
- Atlas: neutral para noticias
- Orion: profundo para documentales
Sin robótica excesiva
La síntesis utiliza motores modernos que reducen la artificialidad del sonido. Los usuarios perciben una voz más natural, lo que mejora la retención y la claridad en menús de respuesta interactiva.
Marca de agua inaudible
Cada archivo de audio generado contiene una marca de agua inaudible que identifica el contenido como voz sintética. Esto asegura transparencia sin afectar la calidad auditiva para el cliente final.
Idiomas y acentos
La API de VozRápida soporta 23 idiomas: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish. Esta cobertura permite desplelar sistemas IVR multilingües sin necesidad de contratar múltiples proveedores o gestionar archivos de audio separados para cada región o mercado objetivo.
Si no se especifica el idioma, el sistema lo infiere basándose en el guión (el texto en latín se asume como inglés por defecto); para textos en latín distintos al inglés se recomienda especificar el parámetro language explícitamente. No se admiten idiomas como vietnamita, tailandés, ucraniano, rumano, checo, bengalí ni otros no listados.
Soporte para 23 idiomas
El conjunto de idiomas incluye aquellos de mayor volumen en centros de llamada globales, garantizando una cobertura amplia para operaciones en América, Europa y Asia.
Los idiomas soportados son: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish.
- Cobertura en más de 23 idiomas distintos
- Soporte nativo para alfabetos latinos, cirílico, árabe y asiáticos
- Idiomas no soportados: vietnamita, tailandés, ucraniano, rumano, checo, bengalí
Detección automática de script
Si no se especifica el parámetro language, el sistema infiere el idioma a partir de los caracteres del texto. Para textos en alfabeto latino que no sean inglés, se recomienda establecer explícitamente el campo language para asegurar la pronunciación correcta.
Esta detección permite simplificar las llamadas API cuando el contenido es predominantemente inglés, pero ofrece precisión cuando se manejan mezclas o idiomas menos comunes en el script enviado.
- Detección automática basada en el script enviado
- Recomendado: especificar
languageexplícitamente para textos latinos no ingleses - Evita errores de pronunciación en textos mixtos
Voces multilingües
Cada una de las 8 voces predefinidas puede pronunciar cualquiera de los 23 idiomas soportados. Esto significa que no se necesitan asignar voces distintas por idioma; una sola voz puede gestionar la interacción completa del IVR en múltiples idiomas, manteniendo una identidad de marca coherente.
Por ejemplo, la voz 'aria' puede leer textos en español, francés o japonés con la misma calidad y tono, lo que simplifica la gestión de recursos en sistemas de respuesta de voz interactiva.
- Todas las 8 voces soportan los 23 idiomas
- Mantienen la misma identidad de marca en cualquier idioma
- No se requieren voces adicionales por idioma
Costes de implementación
La estructura de costes de VozRápida elimina barreras de entrada para startups de call centers. No requiere compras de licencia por asiento ni suscripciones fijas, lo que simplifica la previsión financiera y permite escalar el gasto en función del volumen real de llamadas.
Sin licencia de software
El modelo es puramente API. No hay que adquirir claves por usuario ni pagar cuotas mensuales fijas, independientemente de si el sistema está en uso o en reposo.
Coste variable por uso
El precio es de $0.01 por cada 1.000 caracteres procesados. Los fallos en la síntesis son gratuitos, por lo que solo se paga por audio generado con éxito. No hay cargos ocultos por formatos o idiomas.
- 1 millón de caracteres por $10
Sin inversión inicial alta

Escalabilidad para call centers
La API TTS de VozRápida está diseñada para soportar el volumen variable de los centros de llamada sin necesidad de aprovisionar infraestructura fija. Cada solicitud de síntesis se procesa de forma independiente, permitiendo que el sistema escale horizontalmente según la demanda de tráfico.
Manejo de picos de tráfico
El sistema gestiona múltiples solicitudes simultáneas mediante un modelo de procesamiento secuencial bajo demanda. Las peticiones se procesan secuencialmente; bajo carga, una petición puede esperar en cola.
- Límite de 60 solicitudes por minuto por clave API
- Procesamiento secuencial que mantiene la coherencia del estado
- Sin necesidad de servidores dedicados fijos
Sin límite de usuarios
La escalabilidad no depende del número de agentes ni de líneas telefónicas, sino de la capacidad de la API. Puede integrar la síntesis en cualquier número de sistemas IVR o PBX sin restricciones de licencias por usuario ni costos de infraestructura adicional.
Generación simultánea
Aunque el procesamiento interno es secuencial, la arquitectura permite generar audio para distintas llamadas en intervalos rápidos. Para textos largos, se recomienda dividir el contenido en fragmentos de hasta 4096 caracteres para optimizar el tiempo de respuesta y mantener la fluidez de la llamada.
- Texto máximo de 4096 caracteres por solicitud
- Velocidad típica de 25 caracteres por segundo
- Cola de procesamiento transparente para el usuario final
Mantenimiento simplificado
La API TTS de VozRápida elimina la necesidad de mantener una biblioteca estática de archivos de audio. Al generar el audio bajo demanda, las actualizaciones de contenido se reflejan inmediatamente sin necesidad de redistribuir archivos o actualizar cachés en el PBX.
Actualización de textos en tiempo real
Los mensajes del IVR se actualizan modificando simplemente el texto enviado en la solicitud. No hay retrasos de propagación ni necesidad de volver a generar y subir archivos manualmente, lo que permite reaccionar instantáneamente a cambios operativos.
Sin gestión de archivos MP3
No se almacenan versiones de audio en sus servidores. La API devuelve el archivo directamente en la respuesta, eliminando la sobrecarga de gestionar versiones, compresión y almacenamiento de miles de clips de audio para cada variación de mensaje.
Centralización de contenido
Todo el contenido de voz se gestiona desde la lógica de su aplicación. Esto centraliza la edición de mensajes en un solo lugar, simplificando los flujos de trabajo de desarrollo y asegurando la coherencia en todos los puntos de contacto del IVR.
Ejemplo de flujo IVR
En un flujo IVR típico, el sistema recibe la entrada del usuario mediante DTMF o reconocimiento de voz y determina qué mensaje debe reproducirse. En lugar de cargar un archivo estático desde un servidor de medios, el sistema de control envía el texto correspondiente a la API de VozRápida.
Entrada del usuario
El usuario ingresa una opción en el menú o dicta una consulta. El sistema traduce esta interacción en un texto claro, como "Su llamada será atendida en dos minutos" o el nombre de un agente disponible, listo para ser sintetizado.
Llamada a la API
El servidor IVR realiza una petición POST a https://api.tk999us.info/v1/audio/speech con el texto, el modelo tts-1 y el formato wav para máxima compatibilidad con PBX. La respuesta contiene directamente el archivo de audio binario.
- Endpoint: POST /v1/audio/speech
- Modelo: tts-1
- Formato recomendado: wav
Reproducción de audio generado
El sistema de telecomunicaciones recibe el archivo de audio binario y lo reproduce. Al ser generado bajo demanda, el mensaje siempre refleja el estado actual (ej. tiempos de espera actualizados), sin necesidad de gestionar archivos estáticos.
Formatos recomendados para PBX
La selección del formato de audio depende de la capacidad de tu centralita y de los recursos de red. VozRápida permite elegir entre WAV, MP3 y OPUS según tus necesidades de compatibilidad o eficiencia.
Uso de WAV para compatibilidad
WAV es un formato ampliamente soportado por sistemas de respuesta de voz y PBX, ofreciendo audio sin pérdida.
Uso de MP3 para eficiencia
MP3 reduce el tamaño del archivo, optimizando el ancho de banda para IVR con alto tráfico o conexiones menos robustas.
Soporte de OPUS
OPUS ofrece una excelente relación calidad-tamaño y es eficiente en redes modernas si tu infraestructura PBX lo soporta.
Limitaciones conocidas
La API ofrece una interfaz REST directa sin capas de marcado adicionales. Esto reduce la complejidad de integración en sistemas IVR legacy o personalizados, pero requiere que el desarrollador gestione la estructura del texto desde la aplicación.
Sin SSML nativo
El servicio no interpreta etiquetas SSML para controlar pausas, énfasis o entonación específica. La prosodia es automática y basada en el estilo de la voz seleccionada. Para ajustes finos, se debe modificar el texto de entrada o dividir la frase en múltiples solicitudes.
Límite de caracteres
Cada solicitud HTTP está limitada a 4096 caracteres. Si el guion de la llamada excede este límite, es necesario fragmentar el texto y unir los archivos de audio resultantes en el lado del cliente o del PBX.
Procesamiento secuencial
Las solicitudes se procesan en cola. Bajo carga, puede haber un ligero retraso antes de que se genere el audio. Para IVR crítico, se recomienda pre-generar los audios de menús estáticos y almacenarlos localmente, usando la API principalmente para contenido dinámico como nombres o saldos.
Escucha las 8 voces
Cada muestra a continuación fue generada por esta API a partir de la misma frase. Cada formato tiene implicaciones distintas en el consumo de ancho de banda y la compatibilidad con los reproductores de los sistemas de llamada.
23 idiomas
Cualquier voz puede hablar cualquiera de estos idiomas.
