Documentación de la API de Suno — genera música a partir de una indicación (V5 / V5.5), con precios

Suno es un modelo de música con IA líder en su categoría: genera canciones completas con voces, letras e instrumentación a partir de un prompt de texto. La API de Suno (V5 y V5.5 de Suno en Kunavo) lo hace mediante programación a través de POST /v1/audio/music y devuelve pistas de audio alojadas usando un único token bearer. Esta es la documentación práctica: estructura de la solicitud, precios y patrón asíncrono para producción.

Llama a la API de Suno

Genera una clave en /app/keys y envía un POST con un prompt. Una solicitud devuelve aproximadamente dos variaciones de pista; la generación tarda de decenas de segundos a un par de minutos:

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

Todos los parámetros y el ciclo de vida asíncrono de las tareas están en la referencia de la API de música.

Precios

Suno cobra por solicitud de generación (no por pista), por lo que las ~2 variaciones recibidas cuestan un solo cargo. Las tarifas actuales aparecen en la página de cada modelo. Suno no publica un precio de API por solicitud: su propia API es un programa exclusivo para socios sin tarifas públicas; por eso la tabla muestra únicamente lo que factura Kunavo.

Paga según el uso desde una recarga mínima de $10; el saldo nunca caduca y las generaciones fallidas nunca se cobran. Calcula un uso más amplio con la calculadora de costes.

Modo personalizado: tus propias letras

En lugar de un prompt simple, proporciona lyrics, un descriptor de style y un title para tener control total, o configura instrumental: true para omitir completamente las voces:

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

Asíncrono en producción

La generación de música no es instantánea, así que a escala debes enviar una tarea y consultar el resultado periódicamente en lugar de mantener la conexión abierta; la documentación de música cubre el ciclo de vida de las tareas, la consulta periódica y la entrega mediante webhook. Las URL de los resultados son permanentes una vez completada la tarea.

Kunavo frente a usar Suno directamente

El producto propio de Suno es una suscripción con una asignación de créditos, no una API de pago por uso; esa es precisamente la razón por la que los desarrolladores terminan buscando una «API de Suno»:

Si generas música dentro de un producto, la facturación por consumo y un endpoint real son lo importante. Si una persona trabaja manualmente en un navegador para crear pistas, la suscripción propia de Suno es una compra más sencilla.

API de Suno frente a API de Udio

Udio es la otra gran familia de generación musical, y «API de Udio» es una búsqueda paralela habitual. La diferencia práctica actual: el acceso a la API de Udio funciona mediante vías experimentales de terceros sin un precio público estable, mientras que Suno V5 / V5.5 en Kunavo es un endpoint compatible con una tarifa fija y publicada ($0.09 por solicitud de generación). Si necesitas una generación musical fiable en producción, la API de Suno V5 aquí es la vía fiable; evaluaremos Udio cuando exista un proveedor ascendente estable.

Más allá de la música

La misma clave da acceso a texto (Claude, GPT), imagen (Nano Banana, GPT-Image-2) y vídeo (Veo 3, Seedance 2, Wan 2.7), por lo que puedes encadenar un flujo completo: escribir el guion con un LLM, generar imágenes y añadir una banda sonora de Suno. Consulta la guía de IA multimodal para flujos de imagen → vídeo → música.

Preguntas frecuentes