Introducción
Describe toda la escena de audio en un solo prompt: quién habla, cómo, y sus líneas entre comillas, además de cualquier música, ambiente o efecto de sonido. La tarea devuelve un archivo de audio de hasta unos dos minutos con todo lo que describiste, incluido el diálogo de más de un hablante: un MP3, salvo que definas output_format. Para reutilizar una voz, sube hasta tres clips de referencia en reference_audio_urls y nómbralos @Audio1 a @Audio3 en el prompt, o indica una imagen de referencia en image_url en su lugar; speed, pitch y volume ajustan finamente la interpretación. SpicyAPI no aplica ningún filtro de contenido: cada prompt se lee tal como está escrito. Cada solicitud cuesta el mismo precio fijo.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Audio |
| Campo obligatorio | prompt — de 1 a 2.000 caracteres |
| Campos opcionales |
|
| Resultado | Un archivo de audio de hasta unos dos minutos: MP3 por defecto, o WAV, Ogg Opus, PCM |
| Hablantes | Varios, descritos en el prompt o tomados de hasta tres clips de referencia; sin lista de voces |
| Cantidad facturada | Un precio plano por solicitud |
| Retención | El audio generado se conserva 14 días |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe toda la escena en hasta 2.000 caracteres: cada hablante y cómo suena, sus líneas exactas entre comillas, y cualquier música, ambiente o efecto de sonido. mínimo 1 caracteres · máximo 2000 caracteres |
reference_audio_urls | No | Hasta tres clips MP3 o WAV de referencia: súbelos o indica URL públicas. Cada clip puede durar hasta 30 segundos y pesar hasta 10 MB. máximo 3 elementos |
image_url | No | Imagen de referencia opcional en torno a la cual se crea el audio: súbela o indica una URL pública y describe en prompt lo que dice la persona de la imagen o cómo suena la escena. mínimo 1 caracteres |
speed | No | Velocidad del habla de 0.5 (más lenta) a 2 (más rápida); 1 es el ritmo normal de la voz. No cambia el precio. |
pitch | No | Desplazamiento de tono en semitonos, de -12 a 12; 0 mantiene el tono propio de la voz. No cambia el precio. |
volume | No | Multiplicador de volumen de 0.5 a 2; 1 es el nivel normal. No cambia el precio. |
output_format | No | Formato de archivo: mp3 (predeterminado), wav, opus (Ogg Opus) o pcm, es decir, muestras estéreo de 16 bits little-endian, intercaladas y sin encabezado, con el |
sample_rate | No | Frecuencia de muestreo del audio en Hz: 8000, 16000, 24000, 32000, 44100, 48000. Predeterminado: 24000. |
Precios
$0.36 / solicitud
Un precio plano por solicitud, un clip de hasta unos dos minutos.
Casos de uso
Audiodramas con varios personajes
Describe dos o más hablantes y pon sus líneas entre comillas, y el modelo le dará a cada uno una voz distinta en el mismo clip, sin necesitar un modelo de voz separado para cada personaje.
Escenas con diseño sonoro
Un solo prompt puede pedir diálogo, música de fondo, ambiente y efectos de sonido a la vez, de modo que una sola solicitud devuelva una escena terminada en lugar de una simple línea de voz.
Ficción de audio sin censura
Los prompts se leen tal como están escritos, sin filtro de contenido. En nuestras pruebas, un monólogo en primera persona, ficción narrada y una escena con ambiente de lluvia, todos escritos más allá de lo que aceptan otros servicios, volvieron con cada palabra dicha.
Pistas de voz para video
Genera la escena aquí y luego entrega el MP3 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
Describe a los hablantes
Indica quién habla y cómo —un susurro entrecortado, un narrador cálido— y pon sus palabras exactas entre comillas.
Agrega el paisaje sonoro
Menciona cualquier música, ambiente o efecto de sonido que quieras que suene junto al diálogo: una tormenta de lluvia, un reloj haciendo tic-tac, una música que va creciendo.
Mantente dentro de los 2.000 caracteres
Un prompt cubre una escena de hasta unos dos minutos; las historias más largas deben dividirse en varias solicitudes.
Qué devuelve
Un archivo de audio por tarea, de hasta unos dos minutos de duración: un MP3 salvo que cambies output_format. El archivo se copia al almacenamiento de SpicyAPI y se conserva 14 días.
Cómo escribir el prompt
Seed Audio 1.0 recibe un único campo prompt (hasta 2.000 caracteres) que describe toda la escena:
- Quién habla y cómo: un susurro, un narrador cálido, una línea gritada.
- Sus palabras exactas, entre comillas.
- Cualquier música, ambiente o efecto de sonido que quieras junto al diálogo.
Este modelo admite más de un hablante en el mismo clip: describe a cada personaje y sus líneas, y le dará a cada uno una voz distinta.
Audio e imagen de referencia
No hay lista de voces. Para reutilizar una voz o un sonido, sube hasta tres clips en reference_audio_urls y nómbralos en el prompt como @Audio1, @Audio2 y @Audio3, según el orden de carga; por ejemplo, “Con la voz de @Audio1, un hombre dice …”. O da una imagen en image_url y describe lo que dice la persona que aparece o cómo suena la escena; las dos entradas no se pueden combinar. Usa solo voces e imágenes que tengas derecho a usar.
Interpretación y formato
speed (0.5–2), pitch (-12 a 12 semitonos) y volume (0.5–2) afinan la interpretación. output_format elige mp3 (predeterminado), wav, opus (Ogg Opus) o pcm, y sample_rate va de 8000 a 48000 Hz. pcm son muestras estéreo de 16 bits little-endian sin encabezado, así que no se puede escuchar en el navegador; elige wav para obtener las mismas muestras en un archivo reproducible. Nada de esto cambia el precio.
Cobro
Un precio plano por solicitud, sin importar la longitud del prompt. Las solicitudes fallidas no se cobran.
Contenido
SpicyAPI no añade ningún filtro de contenido. En nuestras pruebas, tres prompts que otros servicios rechazan —un monólogo en primera persona, ficción narrada y una escena con ambiente de lluvia— volvieron todos con cada palabra dicha.
SpicyAPI no añade ningún filtro de contenido: los prompts se leen tal como están escritos, sea lo que sea que contengan. Eres responsable de las escenas que describes y del uso que haces del audio resultante, incluido no presentarlo como 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": "bytedance/seed-audio-1.0/text-to-audio",
"input": {
"output_format": "mp3",
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 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.
