Skip to main content
POST

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
predeterminado:"v5.5"
Versión de generación: solo v5 / v5.5; si se omite, por defecto v5.5.
string
requerido
Descripción textual del efecto de sonido. Si falta, se devuelve un 400 en el momento del envío (sin cargo). Se recomienda usar prompts en inglés para obtener mejores resultados.
string
predeterminado:"one-shot"
Tipo de efecto de sonido: one-shot (por defecto, un solo golpe) / loop (repetible).
integer
Tempo, 1300; los valores fuera de rango devuelven 400 directamente en el momento del envío.
string
Enumeración de tonalidad musical: tonalidades mayores C / C# / D / D# / E / F / F# / G / G# / A / A# / B; las menores añaden m (Cm / C#m / … / Bm). Solo se admite la notación con sostenidos (#); los bemoles (Db / Eb, etc.) y B# devuelven 400 (key param error).
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, toma audio_url de data.result.music[]. En caso de fallo, data.error.message indica la razón y la cuota reservada se reembolsa automáticamente.

Response

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