Introducción
Envía hasta 1000 caracteres de texto en inglés y, opcionalmente, cuán expresiva, variada y ceñida debe ser la lectura. La tarea devuelve un archivo WAV (24 kHz, 16 bits, mono) leído en la voz integrada de Chatterbox o en la voz de un clip corto que envíes en reference_audio_url. Las etiquetas como se leen en voz alta, así que escribe los sonidos en letras en su lugar. SpicyAPI no aplica ningún filtro de contenido: los guiones sin filtro se leen tal como están escritos. Cada solicitud cuesta el mismo precio fijo.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Audio |
| Campo obligatorio | text — de 1 a 1000 caracteres en inglés |
| Campos opcionales | exaggeration (0–1), temperature (0.05–2), |
| Resultado | Un archivo WAV, 24 kHz, 16 bits, mono |
| Voz | Voz integrada o clonada desde |
| Cantidad cobrada | Un precio fijo por solicitud |
| Retención | El audio generado se conserva 14 días |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
text | Sí | Hasta 1000 caracteres de inglés, leídos exactamente como están escritos. Las etiquetas como se leen en voz alta; escribe los sonidos en letras en su lugar. mínimo 1 caracteres · máximo 1000 caracteres |
reference_audio_url | No | Clip opcional en MP3 o WAV de la voz que quieres imitar: súbelo o indica una URL pública. La lectura adopta el timbre de ese clip; sus palabras no se repiten. mínimo 1 caracteres |
exaggeration | No | Cuán emotiva es la lectura, de 0 (neutra) a 1 (dramática). Predeterminado: 0.5. |
temperature | No | Variación entre tomas, de 0.05 a 2. Predeterminado: 0.7. |
guidance_scale | No | Cuán ceñida está la lectura al ritmo natural del texto, de 0.1 a 1. Predeterminado: 0.5; bájalo para ralentizar una lectura apresurada. |
Precios
$0.036 / solicitud
Un precio fijo por solicitud de hasta 1000 caracteres.
Casos de uso
Líneas para juegos y animación
Líneas de personaje cortas y contundentes, donde la energía importa más que el timbre elegido. Sube exaggeration para líneas gritadas, entre risas o sin aliento.
Voces de prototipo
Ponle voz a una demo, un guión gráfico o un chatbot antes de elegir la voz definitiva, a un precio fijo por línea.
Historias de audio sin censura
Los guiones sin filtro se leen tal como están escritos. En nuestras pruebas el modelo pronunció cada palabra de los monólogos y las narraciones enviados, y también los sonidos escritos en letras.
Pistas de voz para video
Genera la línea aquí y luego entrega el WAV a un modelo de avatar parlante o de sincronización labial para que un rostro la interprete.
Guía de prompts y consejos prácticos
Envía el guión en texto
Hasta 1000 caracteres de inglés, con puntuación para las pausas. Escribe las risas y los suspiros con letras: las etiquetas se leen en voz alta.
Ajusta la energía
exaggeration usa 0.5 de forma predeterminada. Súbelo para líneas dramáticas o sin aliento, bájalo para una narración calmada.
Afina si es necesario
Baja
guidance_scalepara ralentizar una lectura apresurada; sube temperature para más variedad entre tomas.
Qué devuelve
Un archivo WAV por tarea: 24 kHz, 16 bits, PCM mono. El archivo se copia al almacenamiento de SpicyAPI y se conserva 14 días. El resultado no incluye marcas de tiempo por palabra ni subtítulos.
La voz
Chatterbox es el modelo de inglés de código abierto de Resemble AI (licencia MIT). Sin referencia, lee con su voz integrada; no hay lista de voces. Envía un clip corto en MP3 o WAV en reference_audio_url para clonar una voz: la lectura adopta el timbre del clip, no sus palabras. Funcionan mejor unos segundos de una sola voz clara, sin música, y debes tener derecho a usar esa voz.
Controles
exaggeration(0–1, predeterminado 0.5): cuán emotiva es la lectura.temperature(0.05–2, predeterminado 0.7): variación entre tomas.guidance_scale(0.1–1, predeterminado 0.5): cuán ceñida está la lectura al ritmo del texto; alrededor de 0.3 ralentiza una entrega rápida y dramática.
En nuestras pruebas, etiquetas como <laugh>, <sigh> o [gasp] se leyeron en voz alta como palabras. Escribe los sonidos en letras en su lugar: "ja…", "mmm…", "ahh…".
Longitud
text acepta hasta 1000 caracteres. En nuestras pruebas, un párrafo de 270 caracteres resultó en unos 15 segundos de audio; la mayoría de las tareas terminaban en 10 a 30 segundos.
Cobro
Un precio fijo por solicitud. Las solicitudes fallidas no se cobran.
Contenido
SpicyAPI no aplica ningún filtro de contenido. En nuestras pruebas, los guiones sin filtro se leyeron palabra por palabra, sin omitir nada y sin que ningún clip terminara antes de tiempo.
SpicyAPI no añade ningún filtro de contenido: los guiones se leen tal como están escritos, sin suavizar nada. Eres responsable de los guiones que envías y del uso que le des al audio resultante, incluido no presentarlo como las palabras de una persona real.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "resemble-ai/chatterbox-v1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
