Suno API: stato ufficiale, chiavi API e un esempio in Python

Al 17 ottobre 2026 Suno ha un'API ufficiale, ma non ci si può iscrivere: platform.suno.com mostra solo l'accesso per chi ha già un account API, senza documentazione pubblica, prezzi o attivazione autonoma, e a luglio Suno ha detto che parte con un gruppo selezionato di partner. Senza invito, oggi funzionano altre due strade.

Esiste un'API ufficiale di Suno?

Suno pubblicizza un'API su platform.suno.com, e quella singola pagina è tutta la sua facciata pubblica.

Il titolo promette «original songs, covers, and mashups from a single prompt» dietro «a simple REST API», e l'unica azione sulla pagina è accedere con l'account Google collegato al tuo account Suno o con un codice via email. Gli altri link sono suno.com, Terms e Privacy, e nient'altro; /docs e /pricing sullo stesso dominio restituiscono la stessa schermata di accesso (verificato il 17 ottobre 2026). L'API esiste, ma la sua documentazione e i prezzi si vedono solo dopo l'accesso.

La chiamata ai partner si conosce da Music Business Worldwide, che il 2 luglio 2026 ha riportato che il chief product officer di Suno, Jack Brody, ha annunciato i piani in un post su LinkedIn il 1° luglio, con il link a un modulo di adesione. Il modulo, come lo cita il servizio, dice: «We're beginning to explore a developer API, starting with a curated group of partners.» In altre parole, Suno inizia a esplorare un'API per sviluppatori con un gruppo selezionato di partner. Nessuna data di lancio è stata annunciata, e non ne aggiungono una né la pagina della piattaforma, né le note di rilascio, né il centro assistenza di Suno.

Per le aziende la strada passa dalle vendite: i Termini di Suno dicono «if you are an enterprise user, you must contact sales to use our Service». Lo stesso servizio nota che Suno «has not released self-serve developer access or published its own API documentation», e questo corrisponde a ciò che la pagina mostra ancora a ottobre.

Tre modi per chiamare Suno dal codice oggi

Accesso partner ufficiale. Il modulo che Brody ha linkato a luglio è l'unica porta che Suno ha mostrato, e il servizio descrive un accesso anticipato per un gruppo selezionato di partner, non un'iscrizione aperta. Il 17 ottobre 2026 la pagina della piattaforma contiene solo la schermata di accesso, senza modulo, lista d'attesa o link per chiedere l'accesso, e non abbiamo trovato un link pubblico al modulo sulle pagine di Suno. Music Business Worldwide non ha riportato tempistiche per un lancio più ampio.

Il wrapper non ufficiale su GitHub. gcui-art/suno-api è la soluzione più nota: 3.259 stelle e circa 100 issue aperte il 17 ottobre 2026, con l'ultimo commit il 6 marzo 2026. Il README dice che l'API ufficiale «is not yet available» e chiede tre cose: il cookie del tuo account Suno, copiato a mano dalla scheda di rete del browser; una chiave 2Captcha a pagamento, perché Suno continua a servire verifiche hCaptcha; e un browser vero pilotato da Playwright con le patch di rebrowser. La issue #262, aperta il 14 dicembre 2025, dice che l'autore «lacks the time to maintain it».

I Termini di servizio di Suno, ultima revisione il 10 agosto 2026 ed efficaci dal 3 settembre 2026, vietano «any data mining, robots, scraping, or similar data gathering or extraction methods» e vietano anche di ottenere contenuti «through any means not intentionally made available or provided for through the Service». Leggi entrambe le clausole nei Termini di Suno prima di costruire un prodotto su un wrapper che pilota suno.com con il tuo cookie. Il README non contiene avvisi in merito; la sua unica riga legale è la licenza LGPL-3.0.

Una piattaforma API di terze parti. OmniaKey è una piattaforma API di terze parti, non è Suno. Vende accesso API a Suno v4.5 e Suno v6 tramite la propria API media asincrona, con una chiave che OmniaKey emette e fattura. La documentazione elenca esattamente due ID modello, suno-v4.5 e suno-v6, e ogni richiesta restituisce una canzone finita e missata, mentre un account Suno ne mostra due alternative. È l'opzione che abbiamo eseguito da capo a fondo qui sotto.

Generare una canzone in Python

Una richiesta crea il task, una seconda chiamata ne controlla lo stato, e l'MP3 finito arriva come link firmato. Esporta la chiave, salva lo script come suno_song.py ed eseguilo; lo script interroga status ogni 5 secondi, perché progress.percent è indicativo e può restare a 0 mentre il task è in corso.

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. Create the job. Reuse the same Idempotency-Key only when retrying this exact request.
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. Poll on status, not on progress.percent, until the job finishes.
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. Download the MP3 now: the signed URL expires in about an hour.
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")

Lo stesso script, eseguito il 17 ottobre 2026, ha stampato due righe:

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

Dall'avvio al file salvato sono passati 82 secondi. Il file è un MP3 stereo a 48 kHz, circa 161 kbps, lungo 2:55, da 3,5 MB, e strumentale perché lo script imposta instrumental su true.

Per confrontare i due modelli nelle due modalità di input, il 17 ottobre 2026 abbiamo anche generato quattro canzoni con l'API di OmniaKey, dalle 13:03 UTC, controllando lo stato ogni 4 secondi.

Tutte e quattro sono finite al primo tentativo, e ogni richiesta ha restituito un MP3. Una descrizione ha prodotto una canzone completa di circa tre minuti; lo stesso stile con otto righe di testo nostro è tornato in 45–63 secondi, quindi con parole tue aspettati un brano corto. Il bitrate andava da 151 a 195 kbps su stereo 48 kHz, e i link firmati di download scadevano circa un'ora dopo la creazione di ogni task.

Parametri e limiti

• Un input.lyrics non vuoto passa alla modalità testo proprio, in cui input.prompt, parameters.style o parameters.tags descrivono lo stile; un task senza prompt e senza testo viene rifiutato.
• suno-v6 si sceglie con l'ID modello e non richiede mv, mentre mv vale solo per la v4.5.
• È servito solo generate. Estensione, testo separato e sintesi vocale falliscono con 503 no_available_channel, e l'addebito iniziale torna indietro.
• Una richiesta è una canzone finita, quindi parameters.n deve essere 1.
• I link ai file sono firmati e di breve durata, circa un'ora, e i record dei task restano 24 ore dopo la creazione.

Errori e rimborsi

Un task che fallisce, viene annullato o non arriva mai al fornitore viene rimborsato automaticamente, e un task annullato che però finisce viene addebitato per lo stato in cui si chiude. Ripetere la stessa chiave di idempotenza con lo stesso corpo restituisce il task originale con un 200 invece di crearne un secondo, quindi un nuovo tentativo dopo un timeout addebita una volta sola. Il recupero è breve: se la creazione va in timeout, reinvia corpo e chiave identici; con l'ID del task in mano, continua a controllarlo.

Domande frequenti

Esiste un'API Suno gratuita?

Suno non pubblica un piano API gratuito su platform.suno.com. I piani gratuiti stanno nell'app suno.com: v6-mini è aperto a tutti e la variante v4.5-all è gratuita dal 21 ottobre 2025. L'output del piano gratuito è solo per uso personale e non commerciale.

Posso usare commercialmente le canzoni di un'API Suno?

I Termini di Suno assegnano l'Output agli abbonati Pro e Premier e permettono l'uso commerciale solo per l'Output «downloaded by you through an approved channel», cioè scaricato da te tramite un canale approvato. L'Output del piano gratuito resta non commerciale, e i remix sono solo per uso personale con qualsiasi piano. Le canzoni di un'API di terze parti non fanno eccezione, quindi leggi i Termini di Suno prima di mettere una canzone generata in un prodotto a pagamento.

Quanto tempo serve per una canzone?

La documentazione audio indica da venti secondi a due minuti per generazione. I nostri quattro task hanno preso da 70 a 105 secondi, e l'esecuzione dello script 82 secondi dall'avvio al file salvato.

Meglio la v4.5 o la v6?

Suno ha annunciato la famiglia v6 il 9 settembre 2026 e la v4.5 il 1° maggio 2025. La v6 si sceglie solo con l'ID modello, mentre la v4.5 accetta parameters.mv per fissare una versione, e l'ID suno-v4.5 di OmniaKey non dice a quale variante della v4.5 corrisponde. Suno chiama la v6 il suo modello di punta, quindi parti da Suno v6 a meno che tu non debba fissare una versione v4.5 più vecchia.

Come ottengo una chiave API di Suno?

Se hai già un account API, accedi a platform.suno.com con l'account Google collegato al tuo account Suno o con un codice via email. Senza account, il modulo per partner di luglio era l'unica porta pubblica, e oggi non è sulla pagina. Una piattaforma di terze parti come OmniaKey emette una chiave propria, separata da qualsiasi accesso a Suno.