API di generazione del testo

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

La generazione del testo crea o riscrive il testo a partire da un tema, dal contesto di un testo esistente e da requisiti di stile. Questo endpoint è già aggiornato al contratto di generazione più recente e può essere usato direttamente per la generazione in modalità professionale.

Endpoint: POST /api/lyrics/generate

Fatturazione: Gratuito entro la quota (al massimo 10 chiamate al minuto e 300 al giorno per utente); oltre la quota gratuita costa 0,1 CNY per chiamata.

Rilevare il superamento: quando la quota gratuita viene superata la richiesta funziona comunque normalmente e le intestazioni di risposta riportano X-Suno-Helper-Free: false e X-Suno-Helper-Over-Limit: minute (o day), così il client può segnalare che questa chiamata è stata addebitata.

Modello consigliato: suno-v6. Sono disponibili suno-v6, suno-v6-wild e suno-v6-mini.

Autenticazione

Parametro	Tipo	Obbligatorio	Note
Authorization	string	sì	`Bearer YOUR_API_KEY`
Content-Type	string	sì	`application/json`

Parametri della richiesta

Parametro	Tipo	Obbligatorio	Predefinito	Note
model	string	sì	-	Nome del modello lato cliente: `suno-v6`, `suno-v6-wild` o `suno-v6-mini`
instruction	string	sì	-	Tema del testo o requisito di generazione
style	string	no	-	Requisito di stile
title	string	no	-	Titolo del brano o vincolo sul titolo
selected	string	no	`""`	Il testo selezionato da riscrivere
context_before	string	no	`""`	Contesto precedente
context_after	string	no	`""`	Contesto successivo
mode	string	no	`apply_user_request`	Modalità di generazione del testo
references	array	no	`[]`	Elenco di materiale di riferimento
num_variants	integer	no	`null`	Numero desiderato di varianti del testo
lyricist_id	string	no	`null`	ID di un paroliere specifico (l'elenco dei parolieri è stato ritirato; nuove integrazioni sconsigliate)
metadata	object	no	-	Parametri estesi; supporta `lyrics_model` e `enable_thinking`
lyrics_project_id	string	no	`null`	ID di un progetto di testi esistente (la serie dei progetti di testi è stata ritirata; nuove integrazioni sconsigliate)

instruction accetta anche i vecchi campi theme e prompt. metadata.lyrics_model è default per impostazione predefinita e metadata.enable_thinking è false per impostazione predefinita.

Controllo della lingua

Questo endpoint non ha un campo di richiesta language separato. La lingua del testo è decisa dal contenuto di instruction; style può solo avere un ruolo di supporto.

Per generare un testo in cinese, indica esplicitamente la lingua di destinazione in instruction, ad esempio:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Puoi anche scrivere "Write the lyrics in Chinese about ...". Per generare un testo in inglese scrivi "请用英文写歌词" o "Write the lyrics in English". Se passi solo un tema in inglese senza indicare la lingua di destinazione, il risultato può essere in inglese.

Esempio di richiesta

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Un testo in italiano sulla stagione dei diplomi e sul ricominciare",
    "style": "pop rock, sincero, ritornello memorabile",
    "title": "Ricominciare",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Risposta

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nIl vento attraversa il cortile\nSalutiamo il giorno di ieri",
    "edited_lyrics": "[Verse]\nIl vento attraversa il cortile\nSalutiamo il giorno di ieri",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics è il testo completo da inserire nella casella dei testi. lyrics_id e lyrics_request_id servono per la tracciabilità e possono essere vuoti a seconda di cosa restituisce l'endpoint; non trattarli come ID di brano.

Note di compatibilità

I vecchi campi theme e prompt funzionano ancora e vengono mappati su instruction.
La serie di endpoint progetti di testi / parolieri è stata ritirata: se devi conservare i risultati generati, salva tu stesso l'edited_lyrics restituito dall'endpoint.

AvantiAPI di clonazione vocale e generazione con voce indicata (non consigliato)

Ottenere una chiave API

Dopo la registrazione puoi creare una chiave API nella console. Ogni generazione costa 0,6 ¥ e restituisce 2 brani, i download sono illimitati e non serve un numero di telefono.

Ottieni chiave API Torna alla panoramica