API de sugestii de prompturi

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Endpoint-ul de sugestii de prompturi returnează descrieri aleatorii de piese, teme de versuri și sugestii de etichete de stil. Se potrivește pentru butoane de „inspirație aleatorie" și „reîmprospătează etichetele".

Endpoint: POST /api/prompts/suggestions

Facturare: Gratuit în limita cotei (cel mult 10 apeluri pe minut și 300 pe zi per utilizator); peste cota gratuită se percepe 0,1 ¥ per apel.

Detectarea depășirii: când cota gratuită este depășită, cererea rulează totuși normal, iar anteturile răspunsului conțin X-Suno-Helper-Free: false și X-Suno-Helper-Over-Limit: minute (sau day), astfel încât clientul poate anunța că acest apel a fost facturat.

Model recomandat: suno-v6. Sunt disponibile suno-v6, suno-v6-wild și suno-v6-mini.

Autentificare

Parametrii cererii

Exemplu de cerere

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

Răspuns

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Scrie versuri în română despre noapte, revedere și regret"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Descrierea câmpurilor