API für Prompt-Vorschläge

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Der Endpunkt für Prompt-Vorschläge liefert zufällige Songbeschreibungen, Songtextthemen und Stil-Tag-Vorschläge. Er passt für Schaltflächen wie „zufällige Inspiration“ und „Tags aktualisieren“.

Endpunkt: POST /api/prompts/suggestions

Abrechnung: Im Kontingent kostenlos (höchstens 10 Aufrufe pro Minute und 300 pro Tag je Nutzer); darüber hinaus 0,1 ¥ pro Aufruf.

Überschreitung erkennen: Wird das kostenlose Kontingent überschritten, läuft die Anfrage trotzdem normal, und die Antwort-Header enthalten X-Suno-Helper-Free: false und X-Suno-Helper-Over-Limit: minute (oder day), sodass der Client darauf hinweisen kann, dass dieser Aufruf berechnet wurde.

Empfohlenes Modell: suno-v6. Verfügbar sind suno-v6, suno-v6-wild und suno-v6-mini.

Authentifizierung

Anfrageparameter

Beispielanfrage

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

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Schreibe einen deutschen Songtext über Nacht, Wiedersehen und Reue"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Feldbeschreibung