Skip to main content
POST
custom controla cómo se interpretan los campos de texto. Con custom=true, prompt contiene la letra y se aplican title, style, negative_tags, auto_lyrics y persona_id. Con custom=false, prompt contiene la inspiración y se ignoran los campos personalizados. style_weight, weirdness_constraint, audio_weight y vocal_gender se validan y aplican en ambos modos.
Este endpoint usa nombres algo distintos: style en lugar de tags.

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).
boolean
predeterminado:"false"
false = modo inspiración; true = modo personalizado (prompt se usa como letra). Por defecto false.
boolean
predeterminado:"false"
true = solo instrumental, sin voz. Por defecto false.
string
Versión pública: v6 / v6-wild / v6-mini. Es obligatorio indicar este campo o custom_model_id; omítelo al usar un modelo personalizado.
string
UUID completo de la tarea del modelo personalizado. Incompatible con version y persona_id; al indicarlo se aplica la tarifa del modelo personalizado.
string
Inspiración/letra. Obligatorio con custom=false, máximo 3.000 caracteres; también obligatorio con custom=true e instrumental=false, máximo 5.000. Opcional para música instrumental personalizada.
string
Título del modo personalizado, hasta 80 caracteres. Se ignora con custom=false.
string
Etiqueta de estilo en modo personalizado, hasta 1.000 caracteres. Se ignora con custom=false.
string
Etiquetas de estilo negativas (estilos que no quieres). Solo tiene efecto cuando custom=true.
boolean
true = reescribir de forma creativa la letra proporcionada. Solo tiene efecto cuando custom=true.
string
ID de estilo de Persona. Solo se aplica con custom=true y es incompatible con custom_model_id.
string
Género de la voz: Male / Female (también se aceptan m / f / male / female, el backend los normaliza automáticamente). Funciona en ambos modos.
number
Peso del estilo, de 0.00 a 1.00. Se valida y aplica en ambos modos.
number
Puntuación de creatividad, de 0.00 a 1.00. Se valida y aplica en ambos modos.
number
Peso del audio, de 0.00 a 1.00. Se valida y aplica en ambos modos.
string
Variación de estilo: off / normal / high / extra / max. Opcional, sin valor predeterminado fijo.
boolean
predeterminado:"false"
Indica si se activa el modo Max. Requiere custom=true y cuesta el doble del precio normal.
string
Formato de audio de salida: mp3 / m4a / wav. Si se omite, el servicio elige el valor predeterminado.
integer
Duración objetivo de 10–360 segundos. Solo con custom=true; la duración final depende del resultado de la tarea.
Obtener resultado: consulta la tarea asíncrona cada 3–5 segundos. La generación suele tardar 30–120 segundos; el estado puede ser pending o processing y el progreso no cambia necesariamente a intervalos fijos. Al terminar, lee audio_url de data.result.music[] (también incluye image_url, video_url, title, duration, etc.). Si falla, el importe descontado se reembolsa.

Response

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