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:"v6"
Versión pública: v6 / v6-wild / v6-mini; valor predeterminado al omitirla: v6.
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).
string
Formato de audio de salida: mp3 / m4a / wav.
Esta API no admite modelos personalizados, Max, variety ni duración objetivo.
Obtener resultado: esta API crea una tarea asíncrona. Consulta GET /v1/music/tasks/{task_id} cada 3–5 segundos hasta que status sea completed o failed. Durante el proceso puede ser pending o processing; progress es un entero de 0 a 100, sin cambios por intervalos fijos garantizados. Al terminar, lee audio_url de data.result.music[]. Si falla, el motivo aparece en data.error.message y el importe descontado se reembolsa automáticamente.

Response

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