Suno API: estado oficial, claves de API y un ejemplo en Python

A 17 de octubre de 2026, Suno tiene una API oficial, pero no puedes registrarte: platform.suno.com solo muestra un inicio de sesión para cuentas de API existentes, sin documentación, precios ni acceso por tu cuenta, y Suno dijo en julio que empieza con un grupo seleccionado de socios. Sin invitación, hoy funcionan otras dos opciones.

¿Existe una API oficial de Suno?

Suno anuncia una API en platform.suno.com, y esa única página es toda su cara pública.

El titular promete «original songs, covers, and mashups from a single prompt» detrás de «a simple REST API», y la única acción de la página es iniciar sesión con la cuenta de Google vinculada a tu cuenta de Suno o con un código enviado por correo. Sus otros enlaces son suno.com, Terms y Privacy, y nada más; /docs y /pricing en el mismo dominio devuelven ese mismo cuadro de inicio de sesión (revisado el 17 de octubre de 2026). La API existe, pero su documentación y sus precios solo se ven después de entrar.

La convocatoria de socios se conoce por Music Business Worldwide, que informó el 2 de julio de 2026 de que el director de producto (CPO) de Suno, Jack Brody, anunció los planes en una publicación de LinkedIn el 1 de julio y enlazó un formulario de solicitud. El formulario, tal como lo cita el artículo, dice: «We're beginning to explore a developer API, starting with a curated group of partners.» No se anunció fecha de lanzamiento, y nada en la página de la plataforma, las notas de versión ni el centro de ayuda de Suno añade una.

A los compradores empresariales se les dirige a ventas: los Términos de Suno dicen «if you are an enterprise user, you must contact sales to use our Service». El mismo artículo señala que Suno «has not released self-serve developer access or published its own API documentation», lo que coincide con lo que la página sigue mostrando en octubre.

Tres formas de llamar a Suno desde código hoy

Acceso oficial de socio. El formulario que Brody enlazó en julio es la única puerta que Suno ha mostrado, y el artículo describe acceso temprano para un grupo seleccionado de socios, no un registro abierto. El 17 de octubre de 2026 la página de la plataforma solo tiene el cuadro de inicio de sesión, sin formulario, lista de espera ni enlace para pedir acceso, y no encontramos ningún enlace público al formulario en las páginas de Suno. Music Business Worldwide no dio fechas para un lanzamiento más amplio.

El envoltorio no oficial de GitHub. gcui-art/suno-api es el rodeo más conocido: 3.259 estrellas y unos 100 issues abiertos el 17 de octubre de 2026, con el último commit el 6 de marzo de 2026. Su README dice que la API oficial «is not yet available» y pide tres cosas: la cookie de tu propia cuenta de Suno, copiada a mano desde la pestaña de red del navegador; una clave de pago de 2Captcha, porque Suno sigue sirviendo desafíos de hCaptcha; y un navegador real manejado con Playwright y los parches de rebrowser. El issue #262, abierto el 14 de diciembre de 2025, dice que al autor «lacks the time to maintain it».

Los Términos de Servicio de Suno, revisados por última vez el 10 de agosto de 2026 y vigentes desde el 3 de septiembre de 2026, prohíben «any data mining, robots, scraping, or similar data gathering or extraction methods» y también obtener contenido «through any means not intentionally made available or provided for through the Service». Lee esas dos cláusulas en los Términos de Suno antes de construir un producto sobre un envoltorio que maneja suno.com con tu propia cookie. El README no incluye ninguna advertencia al respecto; su única línea legal es la licencia LGPL-3.0.

Una plataforma de API de terceros. OmniaKey es una plataforma de API de terceros, no Suno. Vende acceso por API a Suno v4.5 y Suno v6 a través de su propia API asíncrona de medios, con una clave que OmniaKey emite y factura. Su documentación lista exactamente dos ID de modelo, suno-v4.5 y suno-v6, y cada solicitud devuelve una canción terminada y mezclada, mientras que una cuenta de Suno te muestra dos alternativas. Esa es la opción que ejecutamos de principio a fin más abajo.

Genera una canción en Python

Una solicitud crea un trabajo, una segunda llamada consulta su estado y el MP3 terminado llega como enlace firmado. Exporta tu clave, guarda el script como suno_song.py y ejecútalo; el script consulta status cada 5 segundos, porque progress.percent es orientativo y puede quedarse en 0 mientras el trabajo avanza.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Crea el trabajo. Reutiliza el mismo Idempotency-Key solo al reintentar esta misma solicitud.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Consulta status, no progress.percent, hasta que el trabajo termine.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Descarga el MP3 ahora: la URL firmada caduca en cerca de una hora.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Ejecutamos ese mismo script el 17 de octubre de 2026 e imprimió dos líneas.

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

Desde el inicio hasta el archivo guardado pasaron 82 segundos. El archivo es un MP3 estéreo de 48 kHz a unos 161 kbps, de 2:55, 3,5 MB, e instrumental porque el script pone instrumental en true.

Para comparar los dos modelos en ambos modos de entrada, también creamos cuatro canciones con la API de OmniaKey el 17 de octubre de 2026, desde las 13:03 UTC, consultando cada 4 segundos.

Las cuatro terminaron al primer intento y cada solicitud devolvió un MP3. Una descripción produjo una canción completa de unos tres minutos; el mismo estilo con ocho líneas de letra propia volvió en 45 a 63 segundos, así que cuenta con una pista corta cuando escribas tu letra. Los bitrates fueron de 151 a 195 kbps en estéreo de 48 kHz, y los enlaces firmados de descarga caducaron cerca de una hora después de crear cada trabajo.

Parámetros y límites

• Un input.lyrics no vacío cambia al modo de letra propia, donde input.prompt, parameters.style o parameters.tags describen el estilo; un trabajo sin prompt ni letra se rechaza.
• suno-v6 se elige por el ID de modelo y no necesita mv, mientras que mv solo se aplica a v4.5.
• Solo se sirve generate. Extender, generar solo la letra y la síntesis de voz fallan con 503 no_available_channel, y el cargo previo se devuelve.
• Una solicitud es una canción terminada, así que parameters.n debe ser 1.
• Los enlaces de los archivos están firmados y duran poco, cerca de una hora, y los registros de las tareas se guardan 24 horas desde su creación.

Errores y reembolsos

Un trabajo que falla, se cancela o nunca llega al proveedor se reembolsa automáticamente, y una tarea cancelada que aun así termina se cobra por el estado en que acaba. Repetir la misma clave de idempotencia con el mismo cuerpo devuelve la tarea original con un 200 en lugar de crear un segundo trabajo, así que un reintento tras un timeout cobra una sola vez. La recuperación es corta: si la creación da timeout, reenvía el mismo cuerpo y la misma clave; cuando tengas un ID de tarea, sigue consultándolo.

Preguntas frecuentes

¿Hay una API de Suno gratis?

Suno no publica ningún nivel gratuito de API en platform.suno.com. Los planes gratuitos están en la app de suno.com: v6-mini está abierto a todos y la variante v4.5-all es gratis desde el 21 de octubre de 2025. Lo que se genera en el nivel gratuito es solo para uso personal y no comercial.

¿Puedo usar comercialmente las canciones de una API de Suno?

Los Términos de Suno asignan el Output a los suscriptores de Pro y Premier, y permiten el uso comercial solo del Output «downloaded by you through an approved channel». El Output del nivel gratuito sigue siendo no comercial, y los remixes son solo para uso personal sea cual sea tu plan. Las canciones de una API de terceros no son una excepción, así que lee los Términos de Suno antes de poner una canción generada en un producto de pago.

¿Cuánto tarda una canción?

La documentación de audio sitúa una generación entre veinte segundos y dos minutos. Nuestros cuatro trabajos tardaron de 70 a 105 segundos, y la ejecución del script tardó 82 segundos desde el inicio hasta el archivo guardado.

¿Uso v4.5 o v6?

Suno anunció la familia v6 el 9 de septiembre de 2026 y v4.5 el 1 de mayo de 2025. v6 se elige solo por el ID de modelo, mientras que v4.5 acepta parameters.mv para fijar una versión, y el ID suno-v4.5 de OmniaKey no dice a qué variante de v4.5 corresponde. Suno llama a v6 su modelo insignia, así que empieza con Suno v6 salvo que necesites fijar una versión antigua de v4.5.

¿Cómo consigo una clave de API de Suno?

Si ya tienes una cuenta de API, inicia sesión en platform.suno.com con la cuenta de Google vinculada a tu cuenta de Suno o con un código enviado por correo. Sin cuenta, el formulario de socios de julio fue la única puerta pública, y hoy no está en la página. Una plataforma de terceros como OmniaKey emite su propia clave, separada de cualquier inicio de sesión de Suno.