Acerca de Seed Audio 1.0
El modelo de audio todo en uno de ByteDance Seed: describe a los hablantes, sus líneas entre comillas y cualquier música, ambiente o efecto de sonido en un solo prompt, y recibe un MP3 de hasta unos dos minutos.
Llámalo con el nombre de modelo bytedance/seed-audio-1.0/text-to-audio en POST /jobs/createTask, desde 54 créditos por generación (0,54 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | No | La imagen de partida. |
output_format | No | Tipo de archivo del resultado. mp3 · wav · opus · pcm · Por defecto: mp3 |
pitch | No | Pitch shift in semitones; 0 keeps the original pitch. ≥ -12 · ≤ 12 · Por defecto: 0 |
prompt | Sí | Describe the whole audio scene: who speaks, how, what they say (in quotes), and any music, ambience or sound effects. |
reference_audio_urls | No | Audio que imitar: una voz, una música o un ritmo. |
sample_rate | No | Sample rate in Hz. The model uses 24000 when omitted. 8000 · 16000 · 24000 · 32000 · 44100 · 48000 |
speed | No | Ritmo al hablar. ≥ 0.5 · ≤ 2 · Por defecto: 1 |
volume | No | Loudness multiplier; 1 is the normal level. ≥ 0.5 · ≤ 2 · Por defecto: 1 |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por generación | ≈ USD |
|---|---|---|
| Estándar | 54 | 0,54 US$ |
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Seed Audio 1.0 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model bytedance/seed-audio-1.0/text-to-audio y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed-audio-1.0/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif",
"output_format": "mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Seed Audio 1.0
¿Cuánto cuesta la API de Seed Audio 1.0?
Seed Audio 1.0 cuesta 54 créditos (0,54 US$) por generación. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Seed Audio 1.0 en la API?
Pon bytedance/seed-audio-1.0/text-to-audio para Efectos de sonido en el campo model de POST /jobs/createTask.
¿Puedo elegir una voz o clonar una?
No hay lista de voces, pero puedes subir hasta tres clips de referencia (reference_audio_urls) y señalarlos en el prompt como @Audio1, @Audio2 y @Audio3, por ejemplo “Con la voz de @Audio1, …”, o dar una imagen de referencia en su lugar (image_url). Si no, cada voz surge de cómo la describas en el prompt. Usa solo voces que tengas derecho a usar.
¿Puede un clip tener más de un hablante?
Sí. Este modelo está diseñado para diálogos con varios personajes: describe a cada hablante y pon sus líneas entre comillas, y le dará a cada uno una voz distinta en el mismo clip.
¿Puedo controlar la velocidad, el tono o el volumen?
Sí. speed (0.5–2), pitch (-12 a 12 semitonos) y volume (0.5–2) tienen sus propios controles deslizantes, y además puedes describir el ritmo y el tono en el prompt, como una voz lenta y suave o una línea gritada.
¿Qué límites tiene la API de Seed Audio 1.0?
Audio de referencia: 3; Longitud del prompt (caracteres): 2,000; Subida máxima: 10 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Seed Audio 1.0 sin escribir código?
Sí. El Playground ejecuta Seed Audio 1.0 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.