Suno V6 API: versiones y migración de su integración

La Suno V6 API de reAPI utiliza el endpoint de audio existente con version: "V6", "V6_MINI" o "V6_WILD". Si migra una integración antigua, revise tanto la versión como los nombres de los campos: la interfaz de Suno utiliza ahora snake_case, mientras que una versión retirada puede superar la validación y fallar después, durante la generación.^[1]

Empiece con model: "suno-music" y una versión V6 explícita. Mantenga el envío y la consulta asíncronos, y guarde los identificadores de las pistas para editarlas después. Actualice primero la construcción de la solicitud y luego la lectura de los resultados terminados. Cambiar el nombre del modelo a suno-v6 no es la forma documentada de seleccionar V6.

Lo esencial

• Envíe V6, V6_MINI o V6_WILD en version; conserve suno-music como ID de la operación que genera canciones.^[1]
• Sustituya los campos camelCase por los nombres snake_case documentados, como custom_mode, negative_tags y audio_id.^[1]
• Deje de enviar versiones retiradas V4–V5.5. Que el esquema acepte una solicitud no significa que el modelo pueda producir audio.^[1]
• V6 es un punto de partida para una dirección musical definida; Mini, para evaluar menor espera; Wild, para explorar. Son criterios basados en las descripciones de Suno, no garantías de rendimiento medido.^[2]
• Presupueste $0.06 por solicitud de canción completada, con dos tomas incluidas. Los efectos de sonido tienen un cargo separado de 13 créditos.^[3]

Qué cambia en una solicitud a Suno V6 API

Suno anunció V6 el 9 de septiembre de 2026, con tres variantes y una transición desde la generación anterior de modelos.^[2] Para quien desarrolla una integración, lo primero es separar el anuncio del producto de los campos que realmente puede enviar.

El anuncio describe funciones más amplias de creación y edición. Eso no incorpora automáticamente cada función de la aplicación de consumo a las solicitudes de audio de reAPI. La generación actual documenta controles de texto y los flujos de audio correspondientes. No añada un campo de imagen o vídeo solo porque el anuncio mencione esas entradas. Implemente contra la referencia completa de parámetros de Suno.^[1]

La referencia de Suno V6 muestra el formato actual. model identifica la operación y version el modelo musical usado en ella. Mantenga ambas decisiones separadas para que elegir Mini no cambie accidentalmente la generación por una operación de edición.^[4]

Este acceso pertenece a reAPI. El formulario público de Suno para desarrolladores sigue describiendo una exploración con socios seleccionados; no entrega una clave de producción mediante autoservicio.^[5]

V6, Suno V6 Mini y Suno V6 Wild: qué valor enviar

Elija según lo que necesite del próximo resultado. Suno presenta el modelo principal como orientado a la precisión, Wild a una exploración menos predecible y Mini a una creación más rápida y eficiente. La tabla aplica esas descripciones a decisiones prácticas.^[2]

Mini no es aquí una tarifa API más económica. La misma operación cuesta igual con las tres variantes. Una respuesta más rápida reduciría la espera, no el precio anunciado de esa solicitud.^[4] No realizamos una comparación controlada de latencia ni de escucha para este artículo. Hasta medir sus propias tareas, interprete «más rápido» como el posicionamiento de Suno.

Para comparar con criterio, mantenga iguales el prompt, el modo y los demás controles; cambie únicamente version. Evalúe ambas tomas. Si también reescribe la letra o cambia el estilo, no sabrá qué modificación produjo la diferencia.

Registre la versión elegida en cada trabajo. La referencia de extensión exige que coincida con la pista original. Un selector para canciones nuevas no debe sobrescribir sin aviso la versión de las extensiones posteriores.^[1]

Suno V6 frente a V5.5: migre versiones y nombres de campos

En una integración existente, la primera diferencia práctica entre Suno V6 y V5.5 es si la solicitud puede terminar. reAPI documenta V4, V4_5, V4_5PLUS, V4_5ALL, V5 y V5_5 como retirados. El esquema conserva esos valores, pero su generación falla y se reembolsa.^[1]

Existen así dos momentos de fallo. Un campo no admitido puede rechazarse al enviar la solicitud. Una versión antigua aceptada puede crear una tarea que falle después. Revisar solo el estado HTTP del POST deja sin detectar el segundo caso.

Compruebe los ajustes guardados y los valores predeterminados del servidor, además del selector visible. Una aplicación puede mostrar «V6» mientras un proceso en segundo plano sigue enviando un payload antiguo.

La referencia completa registra el cambio de nombres del 13 de septiembre de 2026.^[1] Actualice el objeto de solicitud de manera deliberada. Un reemplazo global en resultados almacenados y otras integraciones puede alterar información ajena a esta migración.

Para trabajos nuevos, genere primero una fuente V6 válida y pruebe después las ediciones dependientes. No suponga que elegir V6 convierte cualquier identificador antiguo en una fuente compatible con todas las operaciones.

Las ocho operaciones de la página V6

La página específica de V6 cubre ocho operaciones. Comparten POST /api/v1/audio/generations, pero sus entradas obligatorias difieren.^[4]

La familia completa contiene 18 operaciones asíncronas. Las otras diez están fuera de esta página, pero eso no significa que todas rechacen una versión. suno-replace-section acepta una task_id existente junto con audio_id, o bien upload_url junto con version. La rama de audio subido exige versión; la de pista existente debe omitirla. Mezclar ambas ramas es inválido.^[1]

Si su programa añade globalmente version a cada solicitud Suno, elimine esa suposición. Limite la selección de versión a los constructores que la necesitan. La conversión WAV, la generación de letras y las operaciones de voz también tienen contratos propios de entrada y salida.

Envíe una primera solicitud V6 y espere al audio

Necesita una clave reAPI, créditos suficientes para la operación y un lugar del servidor donde proteger la credencial. El modo inspiración simplifica la primera solicitud: prompt describe la canción y el modelo aporta la letra.^[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

Lea la id de la tarea devuelta y úsela en el endpoint de tareas. TASK_ID es un marcador que debe sustituir por ese valor:

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

Un envío correcto todavía no es audio terminado. Siga consultando mientras la tarea espere o se procese, deténgase si falla y consuma la salida cuando status sea completed. Las consultas no consumen créditos.^[4]

Durante la preparación ejecutamos una generación V6 en el playground de producción. La respuesta final contenía dos entradas tanto en output.audio_urls como en output.tracks. Esto comprueba la cantidad de salidas de ese ejemplo; no es una prueba comparativa de rendimiento o fiabilidad.

Guarde cada output.tracks[].id cuando exista, junto con la ID de su tarea. No sustituya audio_id por la URL del audio. La referencia garantiza la URL de la pista, pero puede omitir metadatos vacíos. Gestione la falta de letras, duración o identificadores antes de habilitar una acción posterior.^[4]

Si quiere letras exactas, active el modo personalizado y añada style y title. El parámetro de versión de Suno V6 no cambia el significado de custom_mode: la duración se respeta en el modo personalizado, con un objetivo entero entre 10 y 360 segundos.^[4]

Cuánto cuesta una llamada V6

La tarifa de Suno V6, consultada el 14 de septiembre, indica $0.06 o 60 créditos por solicitud de canción completada. Incluye ambas tomas. Dividir entre dos da $0.03 por pista devuelta; es una conversión aritmética, no un precio por pista que pueda comprarse por separado.^[3]

Si solo utiliza una toma, la canción aprovechable sigue costando $0.06. Una nueva generación o una operación posterior añade su propio cargo. No hay descuento por escoger Mini ni por pedir una canción más corta dentro del rango admitido.^[4]

Sound FX es diferente: la tarifa original es $0.0125, pero el débito entero es de 13 créditos, equivalentes a $0.013. Presupueste con los créditos cobrados, sin redondear hacia abajo el precio original.^[3]

Configura las credenciales con la guía de Suno API Key. La tabla completa de precios incluye las demás operaciones, mientras que la guía del estado oficial aclara la cuestión independiente del acceso.

Preguntas frecuentes

¿Suno V6 está disponible mediante API?

reAPI documenta V6, V6 Mini y V6 Wild en su endpoint de tareas de audio. Es un servicio separado del formulario de interés para desarrolladores de Suno.^[4][5]

¿Qué distingue a las tres variantes?

Suno orienta V6 a la precisión, Mini a crear más rápido y Wild a explorar. Elija según sus criterios de aceptación; aquí no se afirma una diferencia cuantificada de rendimiento.^[2]

¿Cuestan lo mismo?

Sí, al comparar la misma operación reAPI. Generar una canción cuesta $0.06 por solicitud completada en cualquiera de las variantes.^[3][4]

¿Puedo seguir enviando V5_5?

El esquema lo acepta, pero la generación documentada falla porque esa versión está retirada. Use un valor V6 actual para tareas nuevas.^[1]

¿Qué funciones V6 exigen modificar la integración?

Revise la selección de versión, los campos snake_case y las entradas de cada operación. Las funciones anunciadas para consumidores no se convierten automáticamente en parámetros.^[1]

¿version es opcional?

Entre las ocho operaciones de la página V6, solo en suno-add-vocals y suno-add-instrumental, que usan V6 por defecto. La generación de canciones exige un valor explícito.^[4]

¿Qué duración puede tener una pista?

El objetivo duration del modo personalizado admite 10–360 segundos. No se aplica en el modo inspiración.^[4]

¿Todas las operaciones devuelven dos canciones?

No. El ejemplo de dos tomas corresponde a generar canciones. Letras, WAV, separación y otras operaciones tienen salidas distintas que deben procesarse según su tipo.^[1]

Migre la solicitud y conserve la identidad de la pista

Empiece con una solicitud de versión actual y sígala hasta terminar. Revise el JSON enviado, guarde las ID de tarea y pistas y pruebe la siguiente operación que realmente necesite su aplicación. Ese recorrido completo, incluido el manejo de fallos, es la comprobación útil para una migración a Suno V6 API.

Referencias

1. reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
2. Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
3. reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
4. reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
5. Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.