Saltar al contenido principal
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.
Requisito: concat solo puede unir segmentos producidos por extend (continuación). Si el origen no es un producto de extend (p. ej. una canción completa generada de una sola vez), la petición se rechaza en el envío con un 400 y no se llama al upstream.

Authorizations

Authorization
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

model
string
predeterminado:"suno"
Modelo de audio. Actualmente se pasa suno (si no se pasa, por defecto suno).
task_id
string
requerido
Nuestro task_id de la tarea de origen — debe ser un segmento producido por extend (continuación) (ver la advertencia anterior). Si falta, no es un producto de extend o no se puede resolver el origen, se devuelve un 400 en el momento del envío.
audio_index
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).
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; mientras se genera, status es pending y progress avanza en cola 10 → listo 50 → hecho 100). Al completarse, toma el audio_url de la canción completa de data.result.music[]. En caso de fallo, data.error.message indica el motivo y la cuota descontada previamente se reembolsa automáticamente.

Response

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