Saltar al contenido principal
POST

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).
version
string
predeterminado:"v5.5"
Versión de generación: solo v5 / v5.5; si se omite, por defecto v5.5.
prompt
string
requerido
Descripción textual del efecto de sonido (se mapea al sound del upstream). Si falta, se devuelve un 400 en el momento del envío (sin llamada al upstream, sin cargo).
type
string
predeterminado:"one-shot"
Tipo de efecto de sonido: one-shot (por defecto, un solo golpe) / loop (repetible).
bpm
integer
Tempo, 1300; los valores fuera de rango devuelven 400 directamente en el momento del envío.
key
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

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