Introducción
Envía el texto que se va a leer y, opcionalmente, una de nueve voces, una nota breve sobre la interpretación y un idioma. La tarea devuelve un archivo MP3 (mono, 24 kHz) con el guion leído en esa voz. instructions recibe indicaciones en lenguaje simple, como tono, emoción o ritmo, y no se pronuncia en voz alta. SpicyAPI no aplica ningún filtro de contenido: los guiones NSFW se leen tal como están escritos. Se te cobra por cada 1.000 caracteres del texto que envías, con un mínimo de 100 caracteres.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Audio |
| Campo obligatorio | text — de 1 a 2.000 caracteres |
| Campos opcionales |
|
| Resultado | Un archivo MP3, 24 kHz, mono |
| Cantidad facturada | Caracteres de text enviados, por cada 1.000; mínimo 100 |
| Tiempo típico | Unos 30 segundos para 300 caracteres |
| Retención | El audio generado se conserva 14 días |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
text | Sí | Las palabras que se van a pronunciar, exactamente como están escritas. Se cobra por cada 1.000 caracteres, con un mínimo de 100 por solicitud. mínimo 1 caracteres · máximo 2000 caracteres |
voice_id | No | Una de nueve voces predefinidas. Predeterminado: Serena. |
instructions | No | Indicación en lenguaje simple sobre tono, emoción o ritmo. Da forma a la interpretación y no se pronuncia. máximo 1000 caracteres |
language | No | Idioma de la lectura. auto lo detecta a partir del guion. |
Precios
$0.068 / 1.000 caracteres
Se cobra por cada 1.000 caracteres del texto enviado, contando espacios y signos de puntuación, con un mínimo de 100 caracteres por solicitud. El costo mostrado antes de ejecutar la solicitud es el precio final.
Casos de uso
Voces de personajes y compañía
Nueve voces distintas, desde claras y filosas hasta graves y suaves, cada una con una breve nota sobre cómo habla, mantenida igual durante toda una serie.
Líneas en chino, japonés y coreano
Dylan y Eric hablan los dialectos de Pekín y de Sichuan, y Ono_Anna y Sohee son voces nativas en japonés y coreano, así que las líneas en esos idiomas suenan naturales en lugar de tener acento.
Historias de audio sin censura
Los guiones NSFW se leen tal como están escritos. En nuestras pruebas, el modelo pronunció cada palabra de los monólogos y las narraciones que enviamos, sin saltarse nada ni cortar el clip antes de tiempo.
Pistas de voz para video
Genera la línea aquí y luego entrega el MP3 a un modelo de talking-avatar o lip-sync para que un rostro la interprete.
Guía de prompts y consejos prácticos
Envía el guion en text
Escríbelo exactamente como debe pronunciarse, con puntuación para las pausas. Hasta 2.000 caracteres; menos de 100 se cobra como 100.
Elige una voz
voice_idusa Serena de forma predeterminada, una voz femenina cálida y suave. Ryan y Aiden son voces masculinas en inglés; Ono_Anna y Sohee son en japonés y coreano; Dylan y Eric hablan los dialectos de Pekín y de Sichuan.Describe la interpretación
Escribe una o dos frases en instructions, por ejemplo 'entrecortada y provocadora, cerca del micrófono'. No se pronuncia en voz alta.
Qué devuelve
Un archivo MP3 por tarea, mono de 24 kHz. 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.
Elegir una voz
voice_id acepta una de nueve voces predefinidas y usa Serena de forma predeterminada:
Serena— voz femenina joven, cálida y suaveVivian— voz femenina joven, clara y algo filosaUncle_Fu— voz masculina experimentada, de timbre grave y suaveRyan— voz masculina dinámica, con fuerte impulso rítmicoAiden— voz masculina estadounidense alegreOno_Anna— voz femenina japonesa juguetonaSohee— voz femenina coreana cálida y emotivaDylan— voz masculina joven que habla el dialecto de PekínEric— voz masculina animada que habla el dialecto de Sichuan (Chengdu)
Dirigir la interpretación
instructions recibe una o dos frases en lenguaje simple sobre cómo leer: tono, emoción, ritmo. Da forma a la interpretación y no se pronuncia. Los controles de velocidad y tono no están expuestos; pídelos en instructions.
Idioma
language usa auto de forma predeterminada, que detecta el idioma a partir del guion. Define zh, en, de, fr, es, it, pt, ru, ja o ko cuando un guion corto o con varios idiomas se lea en el idioma equivocado.
Facturación
Se cobra por cada 1.000 caracteres de text, contando espacios, signos de puntuación y saltos de línea, con un mínimo de 100 caracteres por solicitud; instructions es gratis. La cantidad de caracteres se conoce antes de que empiece la tarea, así que el costo mostrado es el cargo final. Las solicitudes fallidas no se cobran.
Contenido
SpicyAPI no aplica ningún filtro de contenido. En nuestras pruebas, los guiones sin filtrar se leyeron palabra por palabra, sin saltarse nada y sin que ningún clip terminara antes de tiempo.
SpicyAPI no aplica ningún filtro de contenido: los guiones NSFW se leen tal como están escritos. 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": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Serena"
}
}'
# 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.





