Skip to main content
POST
Referencia del audio de origen: no hacen falta IDs adicionales para pistas basadas en canciones existentes. Envía la task_id de la tarea de origen y audio_index para elegir en data.result.music[] (desde 1, valor predeterminado 1).
En extend, custom es opcional y vale true de forma predeterminada. Con custom=true, prompt contiene la letra de continuación. Solo custom=false explícito hace que gpt_description guíe la extensión.

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
El task_id nuestro de la tarea que produjo la pista de origen. Si falta o no se puede resolver la fuente, se devuelve un 400 en el momento del envío.
integer
predeterminado:"1"
Selecciona una pista de data.result.music[] de la tarea de origen (desde 1; valor predeterminado 1).
number
requerido
Segundo desde el que empieza la continuación; debe ser al menos 1 y menor que la duración real de la pista. Admite decimales.
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 y persona_id.
boolean
predeterminado:"true"
true = continuar con la letra de prompt; false = continuación inspirada. Valor predeterminado al omitirlo: true.
string
Letra para la extensión. Surte efecto cuando custom=true.
string
Descripción de inspiración. Solo se aplica con custom=false explícito y guía la dirección de la extensión.
string
Título. Solo tiene efecto cuando custom=true.
string
Etiquetas de estilo. Solo tiene efecto cuando custom=true.
string
Etiquetas de estilo a excluir. Solo tiene efecto cuando custom=true.
string
Género de la voz: Male / Female. Funciona en ambos modos.
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.
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.
integer
Duración objetivo de 10–360 segundos. Solo con custom=true; la duración real depende del resultado.
string
Variación de estilo: off / normal / high / extra / max. Opcional.
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.
Resultado: consulta la tarea asíncrona hasta que termine y lee la audio_url de la pista extendida en data.result.music[]. Si falla, el importe descontado se reembolsa.

Response

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