API de génération de paroles

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

Description du point d'accès

La génération de paroles crée ou réécrit des paroles à partir d'un thème, du contexte de paroles existantes et d'exigences de style. Ce point d'accès est déjà passé au contrat de génération de paroles le plus récent et peut servir directement à la génération en mode professionnel.

Point d'accès : POST /api/lyrics/generate

Facturation : Gratuit dans le quota (au maximum 10 appels par minute et 300 par jour par utilisateur) ; au-delà du quota gratuit, 0,1 CNY 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 contiennent 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

instruction accepte aussi les anciens champs theme et prompt. metadata.lyrics_model vaut default par défaut et metadata.enable_thinking vaut false par défaut.

Contrôle de la langue

Ce point d'accès n'a pas de champ de requête language distinct. La langue des paroles est décidée par le contenu de instruction ; style ne peut jouer qu'un rôle d'appoint.

Pour générer des paroles en chinois, indiquez explicitement la langue cible dans instruction, par exemple :

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Vous pouvez aussi écrire "Write the lyrics in Chinese about ...". Pour générer des paroles en anglais, écrivez "请用英文写歌词" ou "Write the lyrics in English". Si vous ne passez qu'un thème en anglais sans indiquer la langue cible, le résultat peut être en anglais.

Exemple de requête

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Des paroles en français sur la saison des remises de diplômes et le fait de repartir",
    "style": "pop rock, sincère, refrain mémorable",
    "title": "Repartir",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nLe vent traverse la cour\nNous disons adieu à hier",
    "edited_lyrics": "[Verse]\nLe vent traverse la cour\nNous disons adieu à hier",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics est le texte complet à saisir dans la zone de paroles. lyrics_id et lyrics_request_id servent au suivi et peuvent être vides selon ce que renvoie le point d'accès ; ne les considérez pas comme des ID de morceau.

Notes de compatibilité

• Les anciens champs theme et prompt fonctionnent toujours et sont mappés vers instruction.
• La série de points d'accès projets de paroles / paroliers est retirée : si vous devez conserver les résultats générés, enregistrez vous-même l'edited_lyrics renvoyé par le point d'accès.