API de suggestions de prompt

Mis à jour le 2026-09-18 · équipe Suno-API

Description du point d'accès

Le point d'accès de suggestions de prompt renvoie des descriptions de morceaux, des thèmes de paroles et des suggestions d'étiquettes de style aléatoires. Il convient aux boutons « inspiration aléatoire » et « rafraîchir les étiquettes ».

Point d'accès : POST /api/prompts/suggestions

Facturation : Gratuit dans le quota (au plus 10 appels par minute et 300 par jour et par utilisateur) ; au-delà du quota gratuit, 0,1 ¥ par appel.

Détecter le dépassement : lorsque le quota gratuit est dépassé, la requête s'exécute quand même normalement, et les en-têtes de réponse portent X-Suno-Helper-Free: false et X-Suno-Helper-Over-Limit: minute (ou day), ce qui permet au client de signaler que cet appel a été facturé.

Modèle recommandé : suno-v6. suno-v6, suno-v6-wild et suno-v6-mini sont disponibles.

Authentification

Paramètres de la requête

Exemple de requête

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éponse

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Écris des paroles en français sur la nuit, les retrouvailles et le regret"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Description des champs