API voor promptsuggesties

Bijgewerkt op 2026-09-18 · Suno-API-team

Beschrijving van het endpoint

Het endpoint voor promptsuggesties geeft willekeurige nummerbeschrijvingen, songtekstthema's en stiltag-suggesties terug. Het past bij knoppen zoals "willekeurige inspiratie" en "tags verversen".

Endpoint: POST /api/prompts/suggestions

Facturering: Gratis binnen het quotum (maximaal 10 aanroepen per minuut en 300 per dag per gebruiker); boven het gratis quotum kost het 0,1 ¥ per aanroep.

Overschrijding herkennen: bij overschrijding van het gratis quotum loopt het verzoek gewoon door, en de antwoordheaders bevatten X-Suno-Helper-Free: false en X-Suno-Helper-Over-Limit: minute (of day), zodat de client kan melden dat deze aanroep is gefactureerd.

Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.

Authenticatie

Verzoekparameters

Voorbeeldverzoek

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

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Schrijf een Nederlandse tekst over nacht, weerzien en spijt"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Veldbeschrijving