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).

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 la fuente no puede resolverse, 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).
string
La letra del fragmento a reemplazar.
number
requerido
Punto inicial del reemplazo (segundos). Si falta, devuelve 400 de inmediato.
number
requerido
Fin en segundos. Debe cumplir 0 ≤ start_s < end_s y no superar la duración conocida.
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.
string
Letra de contexto.
string
Título.
string
Etiquetas de estilo.
string
Etiquetas de estilo a excluir.
string
Variación de estilo: off / normal / high / extra / max. Opcional.
boolean
predeterminado:"false"
Activa el modo Max 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.
prompt es el contexto de la letra original y infill_lyrics la nueva letra. No envíes custom, instrumental, auto_lyrics ni campos antiguos de sesión de edición.
Obtener resultado: consulta la tarea hasta que termine y lee la audio_url de la pista reemplazada 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