Skip to main content
POST
Referenciar la pista de origen: las operaciones basadas en canciones existentes no requieren recordar ningún id anterior; solo pasa task_id (el task_id nuestro de la tarea que produjo la pista de origen) + audio_index (qué canción dentro del resultado music[], basado en 1, por defecto 1).
Este endpoint no tiene dimensión de versión: no pases version; si se pasa, se descarta y no afecta a la facturación.

Authorizations

string
requerido
Todas las interfaces requieren autenticación mediante Bearer TokenObtener la API Key:Visita la página de gestión de API Keys para obtener tu API KeyAl usarla, añade en la cabecera de la petición:

Body

string
predeterminado:"suno"
Modelo de audio. Actualmente se pasa suno (si no se pasa, por defecto suno).
string
requerido
El task_id nuestro de la tarea que produjo la pista de origen. Si falta o la fuente no puede resolverse, se devuelve un 400 en el momento del envío.
integer
predeterminado:"1"
Qué canción dentro de data.music[] del resultado de la tarea de origen (basado en 1; por defecto 1; una generación suele producir 2 canciones: índices 1 y 2).
string
requerido
Nombre de la persona. Si falta, devuelve 400 de inmediato.
string
Descripción.
string
Estilo.
string
El id obtenido de «Extraer Vox».
integer
Inicio del fragmento vocal (segundos). Al referenciar vox_audio_id, debe coincidir con el rango del fragmento usado cuando se extrajo ese Vox.
integer
Fin del fragmento vocal (segundos). Al referenciar vox_audio_id, debe coincidir con el rango del fragmento usado cuando se extrajo ese Vox.
Obtener el resultado: este endpoint es una tarea asíncrona. Tras enviarlo obtienes un task_id; consulta GET /v1/music/tasks/{task_id} cada 3-5 s hasta que status sea completed o failed (suele tardar 30-120 s; durante la generación, status es pending y progress avanza en cola 10 → listo 50 → hecho 100). El resultado incluye la información de la persona. En caso de fallo, data.error.message indica el motivo y la cuota reservada se reembolsa automáticamente.

Response

integer
Código de estado de la respuesta
array
Array de datos devueltos