API di suggerimenti prompt

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

Descrizione dell'endpoint

L'endpoint dei suggerimenti prompt restituisce descrizioni di brani, temi per il testo e suggerimenti di tag di stile casuali. È adatto ai pulsanti "ispirazione casuale" e "aggiorna tag".

Endpoint: POST /api/prompts/suggestions

Fatturazione: Gratis entro la quota (al massimo 10 chiamate al minuto e 300 al giorno per utente); oltre la quota gratuita viene addebitato 0,1 ¥ 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

Parametri della richiesta

Esempio di richiesta

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

Risposta

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Scrivi un testo in italiano su notte, ritrovarsi e rimpianto"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Descrizione dei campi