Modelos compatibles

Actualizado el 2026-09-18 · equipo de Suno-API

Modelos de generación disponibles

Las solicitudes usan únicamente los nombres de modelo de la plataforma que aparecen abajo.

Modelo recomendado por defecto: suno-v6.

Sobre la separación de pistas

La separación de pistas es una capacidad fija e independiente: no hace falta elegir un modelo de generación. Solo hay que enviar la canción original y el modo de separación, por ejemplo two o twelve. El número de pistas que realmente se devuelve es el que indique la respuesta.

El parámetro model

En los endpoints de generación, model suele ser opcional:

• Omitido: se usa el valor predeterminado suno-v6.
• Indicado: debe ser suno-v6, suno-v6-wild o suno-v6-mini.
• Solo se aceptan los nombres de modelo de la tabla anterior.

Ejemplo mínimo de generación

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{
    "description": "una canción folk animada sobre el primer día de primavera",
    "model": "suno-v6"
  }'

Tiempos de espera y timeouts (importante): los endpoints de generación son síncronos — el pedido solo se acepta y se entrega a generación cuando llega la respuesta. Según lo medido, la mayoría de las peticiones responden en 1-3 segundos, alrededor del 10% tarda más de 30 segundos y la más lenta ronda los 230 segundos. Configura el timeout del cliente en 300 segundos o más (el --max-time 300 del ejemplo); no recibir respuesta no significa que no se haya generado nada, y no reintentes justo después de un timeout (eso duplica el pedido y vuelve a cobrar). Si la conexión se cayó, confírmalo más tarde con GET /api/music/songs. Consulta «Tiempos de espera y configuración de timeout» en el Resumen de la nueva API.

Ejemplo con una variante de V6

{
  "model": "suno-v6-wild",
  "description": "una pieza electrónica con estructura experimental"
}

Modelos retirados

Estos modelos ya no aceptan nuevas solicitudes:

• suno-v2
• suno-v3
• suno-v3-5
• suno-v4
• suno-v4-5
• suno-v4-5-all
• suno-v4-5-plus
• suno-v5
• suno-v5-5

Las canciones y tareas antiguas aún pueden mostrar un model_name o model_version antiguo. Son datos históricos: no significa que el modelo antiguo acepte solicitudes nuevas.

Por compatibilidad con clientes antiguos, una solicitud que indique un modelo retirado se procesa con el valor predeterminado actual suno-v6 en lugar de rechazarse. La tarea también registra suno-v6 y no se devuelve ningún error de «modelo no disponible». Aun así, conviene actualizar los ejemplos a los nombres actuales cuanto antes.

Listar modelos

GET /v1/models debe incluir al menos estos modelos de canción:

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

La respuesta también puede contener modelos de letras, rutas de compatibilidad o modelos internos. No los confunda con los modelos V6 de generación de canciones.

Elegir entre las variantes V6

En la mayoría de integraciones basta el modelo predeterminado. Las tres variantes se diferencian en la fidelidad al prompt y en cuánto varía el resultado.

Como cada ejecución devuelve dos pistas, un flujo práctico es bocetar con suno-v6-mini y volver a lanzar el prompt elegido con suno-v6 para elegir la versión que se publica.

Coste y reembolsos

El cobro es por solicitud, no por modelo: cada ejecución cuesta 0,6 ¥ y devuelve dos pistas. Las generaciones fallidas se reembolsan automáticamente, así que un intento fallido no consume saldo. Las descargas son ilimitadas y nunca se cobran aparte.