Documentazione dell’API Suno — genera musica da un prompt (V5 / V5.5), con prezzi

Suno è un modello di musica AI di prima classe: genera brani completi con voce, testi e strumentazione a partire da un prompt testuale. L’API di Suno (Suno V5 e V5.5 su Kunavo) lo fa programmaticamente tramite POST /v1/audio/music, restituendo tracce audio ospitate con un unico bearer token. Questa è la documentazione pratica: struttura della richiesta, prezzi e schema asincrono per la produzione.

Chiama l’API di Suno

Genera una chiave su /app/keys ed esegui POST di un prompt. Una richiesta restituisce circa due varianti della traccia; la generazione richiede da decine di secondi a un paio di minuti:

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"])

I parametri completi e il ciclo di vita asincrono delle attività sono nel riferimento dell’API musicale.

Prezzi

Suno viene fatturato per richiesta di generazione (non per traccia), quindi le circa 2 varianti restituite costano un solo addebito. Le tariffe attuali sono indicate nella pagina di ciascun modello. Suno non pubblica alcun prezzo API per richiesta — la sua API è un programma riservato ai partner senza tariffe pubbliche — quindi la tabella mostra solo ciò che fattura Kunavo.

Pay-as-you-go a partire da una ricarica minima di $10; il saldo non scade e le generazioni non riuscite non vengono mai fatturate. Stima un carico di lavoro più ampio con il calcolatore dei costi.

Modalità personalizzata: i tuoi testi

Invece di un prompt semplice, fornisci lyrics, un descrittore style e un title per il controllo completo, oppure imposta instrumental: true per escludere del tutto la voce:

# 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"
  }'

Asincrono in produzione

La generazione musicale non è istantanea, quindi su larga scala invia un’attività e interroga il risultato invece di mantenere aperta la connessione — la documentazione musicale illustra il ciclo di vita delle attività, il polling e la consegna tramite webhook. Gli URL dei risultati sono permanenti una volta completata l’attività.

Kunavo a confronto con l’uso diretto di Suno

Il prodotto proprietario di Suno è un abbonamento con una quantità di crediti inclusa, non un’API pay-as-you-go a consumo — ed è proprio per questo che gli sviluppatori finiscono per cercare un «Suno API»:

Se generi musica all’interno di un prodotto, la fatturazione a consumo e un endpoint reale sono il punto centrale. Se una persona lavora manualmente nel browser per creare tracce, l’abbonamento proprietario di Suno è l’acquisto più semplice.

API Suno a confronto con API Udio

Udio è l’altra principale famiglia di generazione musicale e «Udio API» è una ricerca parallela comune. La differenza pratica oggi: l’accesso all’API di Udio passa da percorsi sperimentali di terze parti senza un prezzo pubblico stabile, mentre Suno V5 / V5.5 su Kunavo è un endpoint supportato con una tariffa fissa pubblicata ($0,09 per richiesta di generazione). Se ti serve una generazione musicale affidabile in produzione, la Suno V5 API qui è il percorso affidabile; valuteremo Udio quando esisterà un upstream stabile.

Oltre la musica

La stessa chiave raggiunge testo (Claude, GPT), immagini (Nano Banana, GPT-Image-2) e video (Veo 3, Seedance 2, Wan 2.7), così puoi concatenare un’intera pipeline: scrivere lo script con un LLM, generare le immagini e aggiungere una colonna sonora Suno. Consulta la guida all’AI multimodale per i flussi di lavoro immagine → video → musica.

Domande frequenti