Saltar al contenido principal
POST
Este endpoint no tiene dimensión de versión: no pases version — si se pasa, se descarta y no afecta a la facturación.
Limitación conocida: no subas audio puramente instrumental (sin voces) — el upstream puede fallar al analizarlo.

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).
audioFilePath
string
requerido
URL directa de audio de acceso público. Si falta, se devuelve un 400 en el momento del envío (sin llamada al upstream, sin cargo).
Obtener el resultado: esta interfaz es una tarea asíncrona. Tras enviarla obtienes un task_id; consulta GET /v1/music/tasks/{task_id} cada 3-5 s hasta que status sea completed o failed (durante la generación, status es pending y progress avanza: en cola 10 → listo 50 → completado 100). Al completarse, usa el task_id de esta tarea + audio_index=1 como origen para otras operaciones. En caso de fallo, data.error.message indica el motivo y la cuota reservada se reembolsa automáticamente.

Response

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