Endpoint del modelo · POST /v2/generate
Suno v6 API
Genera canciones completas — voces, letra e instrumentación — a través de un único endpoint REST asíncrono. La familia chirp-v6 cubre el modelo Suno v6 insignia, una opción rápida y económica y una variante más experimental, con facturación por solicitud en créditos.
10–12 créditos por canción · 1 USD = 100 créditos
Qué te ofrece la Suno v6 API
La Suno v6 API permite a una aplicación de servidor crear canciones completas a partir de un prompt de texto o de letra personalizada. Eliges un modelo de la familia chirp-v6, envías una solicitud POST y recibes un workId para la tarea asíncrona: voces, estructura e instrumentación se producen por ti.
Tres modelos actuales comparten el mismo endpoint. chirp-v6 es el modelo insignia para lanzamientos en producción. chirp-v6-mini es la opción rápida y económica para grandes volúmenes o prototipos. chirp-v6-wild es la variante más experimental para arreglos más libres y audaces. Cada resultado informa en model_name el modelo que realmente produjo el audio, así puedes migrar integraciones antiguas con seguridad.
Quickstart: crea y consulta una tarea
Envía un POST autenticado a /v2/generate, guarda el workId devuelto y consulta /v2/feed hasta que la tarea termine — o pasa callback_url y espera el webhook.
curl -X POST "https://udioapi.pro/api/v2/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "chirp-v6",
"prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
"style": "pop, upbeat, electronic, 120 bpm",
"title": "Summer Dreams",
"make_instrumental": false
}'
curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"La generación es asíncrona. Consulta cada 5–10 segundos con un tiempo de espera acotado y descarga las URL de audio pronto: los enlaces de medios son temporales.
Modelos y precios de Suno v6
Los tres modelos están disponibles en generate, upload-cover y extend. Los precios son por solicitud; 1 USD compra 100 créditos.
| Modelo | Créditos | ≈ USD | Posicionamiento |
|---|---|---|---|
| chirp-v6 | 12 | ≈ $0.12 | Insignia — canciones de máxima fidelidad para producción |
| chirp-v6-mini | 10 | ≈ $0.10 | Rápido y económico — trabajos por lotes y prototipos |
| chirp-v6-wild | 12 | ≈ $0.12 | Más experimental — arreglos audaces |
Los identificadores antiguos siguen funcionando a su precio histórico: chirp-v5 y chirp-v5-5 son atendidos por chirp-v6; chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus y chirp-v4-5-all por chirp-v6-mini. Omitir el campo de modelo factura el nivel base de 5 créditos atendido por chirp-v6-mini.
Qué puedes construir
La misma cuenta y clave de API desbloquean los endpoints de audio documentados.
Texto y letra a canción
Modo personalizado para letra, estilo y título, o modo de inspiración a partir de una descripción sencilla. El campo opcional image_urls orienta el ambiente.
Leer la documentaciónExtender una pista existente
Continúa una canción generada con la configuración heredada o un nuevo prompt, y recoge el resultado en el feed.
Leer la documentaciónCover de tu propio audio
Sube un audio y produce una versión cover mediante el endpoint upload-cover.
Leer la documentaciónLetras con marcas de tiempo
Obtén los tiempos de cada línea de la letra para experiencias tipo karaoke o sincronizadas.
Leer la documentaciónConversión a WAV
Convierte una pista generada a WAV para masterización o flujos de difusión.
Leer la documentaciónWebhooks y polling
Elige entre polling en el feed y notificaciones por callback para la finalización de la tarea.
Leer la documentaciónCómo funciona
De la clave de API a una pista reproducible en cuatro pasos.
- 1
Crea una clave de API
Inicia sesión, abre el panel y copia una clave. Guárdala como secreto en el servidor, nunca en el código del navegador.
- 2
Envía la tarea
Haz POST a /v2/generate con tu modelo y prompt. La respuesta devuelve un workId para el trabajo asíncrono.
- 3
Consulta o recibe un callback
Llama a GET /v2/feed?workId=... cada 5–10 segundos, o pasa callback_url y gestiona el webhook de finalización.
- 4
Descarga el audio
Con estado SUCCESS, la respuesta del feed contiene URL de audio temporales. Guarda los archivos en tu propio almacenamiento.
Precio sencillo por crédito
1 USD equivale a 100 créditos. Una canción con chirp-v6 cuesta unos $0.12 y con chirp-v6-mini unos $0.10: pagas solo por el modelo elegido, sin suscripción obligatoria para acceder a la API.
Los créditos prepagados nunca caducan. Las solicitudes rechazadas o fallidas se reembolsan automáticamente.
Límites y notas
- Todos los endpoints de generación son asíncronos; la respuesta del POST contiene un workId, no audio.
- Consulta /v2/feed con reintentos acotados o usa callback_url para entrega servidor a servidor.
- Las solicitudes con chirp-v5 y chirp-v5-5 producen audio de chirp-v6; los identificadores antiguos producen chirp-v6-mini.
- Las URL de medios son temporales: descarga y guarda los resultados en tu propio almacenamiento.
- Mantén prompts, títulos y estilos dentro de los límites documentados; los valores más largos se truncan.
udioapi.pro es un servicio independiente de terceros. No está afiliado, respaldado ni operado por Suno, Udio o MiniMax.
Preguntas frecuentes sobre Suno v6 API
Respuestas sobre modelos, facturación y el flujo asíncrono.
¿Es esta la API oficial de Suno?
No. udioapi.pro es un servicio de API independiente de terceros con sus propios endpoints, cuentas, créditos, términos y soporte. No está afiliado, respaldado ni operado por Suno o Udio.
¿Con qué modelo de Suno v6 debo empezar?
Usa chirp-v6-mini para prototipos y grandes volúmenes: es la opción rápida y económica a 10 créditos. Cambia a chirp-v6 (12 créditos) cuando necesites calidad insignia, o a chirp-v6-wild para resultados más experimentales.
¿Cuánto cuesta una solicitud?
chirp-v6 y chirp-v6-wild cuestan 12 créditos por solicitud y chirp-v6-mini cuesta 10. Con 1 USD = 100 créditos son unos $0.10–$0.12 por canción. Omitir el campo de modelo factura el nivel base de 5 créditos atendido por chirp-v6-mini.
¿Cómo obtengo el audio generado?
Toda solicitud aceptada devuelve un workId. Consulta GET /v2/feed?workId=... cada 5–10 segundos hasta que el estado sea SUCCESS, o pasa callback_url para recibir un webhook. La respuesta del feed contiene entonces las URL de audio.
¿Siguen funcionando mis identificadores de modelo antiguos?
Sí. chirp-v5 y chirp-v5-5 son atendidos por chirp-v6, y chirp-v3-5 hasta chirp-v4-5-all por chirp-v6-mini, cada uno a su precio histórico. El campo model_name indica el modelo que produjo el audio.
¿Puedo extender una canción generada o hacer un cover?
Sí: la familia chirp-v6 está disponible en generate, upload-cover y extend. Las extensiones se facturan al precio del modelo de la pista original, y las solicitudes rechazadas o fallidas se reembolsan.