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 no se puede resolver el origen, 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).
integer
requerido
Punto inicial de la eliminación (segundos). Si falta, devuelve 400 de inmediato.
integer
requerido
Punto final de la eliminación (segundos). Si falta, devuelve 400 de inmediato.
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 procesado de data.result.music[]. En caso de fallo, data.error.message indica el motivo y la cuota descontada previamente se reembolsa automáticamente.

Response

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