Skip to main content
POST
Pista de origen: debe proceder de una tarea de carga creada con POST /v1/music/generations/uploadTask. Envía su task_id y usa audio_index para elegir una pista de data.result.music[] (desde 1, predeterminado 1). Una tarea de generación normal no sirve como origen.
custom controla qué campos se aplican. Todo campo enviado debe cumplir los requisitos de tipo, rango y longitud aunque no se aplique en el modo elegido. Con custom=true se aplican los campos de letra y estilo y se ignora gpt_description. Con custom=false solo se aplica gpt_description, que es obligatorio; si falta se devuelve 400. vocal_gender se aplica en ambos modos. Si se omite custom, el servidor lo deduce a partir de prompt, luego gpt_description y después tags o title.

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
requerido
task_id devuelta por POST /v1/music/generations/uploadTask. No sirven tareas de generación normales. Una fuente ausente o no válida devuelve 400 al enviar.
integer
predeterminado:"1"
Selecciona una pista de data.result.music[] de la tarea de origen (desde 1; valor predeterminado 1).
string
predeterminado:"v6"
Versión pública: v6 / v6-wild / v6-mini. Valor predeterminado v6; omítelo al usar custom_model_id.
string
UUID completo devuelto por la tarea de creación del modelo. Incompatible con version.
boolean
true=modo personalizado (prompt se usa como letra); false=modo inspiración (usa gpt_description); si no se pasa, se infiere del contenido (ver el Warning más arriba).
string
Letra. Surte efecto cuando custom=true (se ignora en modo inspiración).
string
Prompt de inspiración. Obligatorio cuando custom=false — si falta, la petición falla con 400 en el envío (no se llama al proveedor y no se cobra nada).
string
Título. Solo tiene efecto cuando custom=true.
string
Etiquetas del estilo objetivo. Solo tiene efecto cuando custom=true.
string
Etiquetas de estilo a excluir. Solo tiene efecto cuando custom=true.
number
Peso del estilo, 0.00-1.00 (los valores fuera de rango devuelven 400 directamente en el momento del envío). Solo tiene efecto cuando custom=true.
number
Peso de creatividad, de 0.00 a 1.00. Se admite el nombre antiguo weirdness_constraint; usa weirdness en solicitudes nuevas.
number
Peso del audio, 0.00-1.00. Solo tiene efecto cuando custom=true.
string
Género de la voz: Male / Female. Funciona en ambos modos.
string
Variación de estilo: off / normal / high / extra / max.
boolean
predeterminado:"false"
Activa el modo Max. Requiere modo personalizado y se factura al doble del precio estándar.
string
Formato de audio de salida: mp3 / m4a / wav. Este endpoint no admite un campo de duración objetivo.
Esta API no admite auto_lyrics, persona_id, instrumental ni duración objetivo.
Obtener resultado: consulta la tarea asíncrona hasta que termine. La generación suele tardar 30–120 segundos. Lee audio_url de data.result.music[]; si falla, el importe descontado se reembolsa automáticamente.

Response

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