API de boost de style

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

Description du point d'accès

Le boost de style développe une étiquette de style courte en une description de style plus complète et mieux adaptée à la génération Suno, et peut aussi générer un passage de style à partir de paroles complètes.

Point d'accès : POST /api/music/boost-style

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.

Sortie en chinois : lorsque le contenu de la requête (originalTags/lyrics/user_guidance) contient du chinois sans langue déclarée, le service ajoute automatiquement （请用中文描述） après original_tags et complète user_guidance=语言：简体中文；乐器名也用中文, afin d'augmenter le taux de réussite des descriptions de style en chinois. Les valeurs réellement envoyées sont renvoyées dans appliedOriginalTags et appliedUserGuidance de la réponse. Si le contenu que vous envoyez indique déjà une langue (par exemple « décris en chinois simplifié »), le service ne modifie rien.

Authentification

Paramètre	Type	Obligatoire	Remarques
Authorization	string	oui	`Bearer YOUR_API_KEY`
Content-Type	string	oui	`application/json`

Paramètres de la requête

Paramètre	Type	Obligatoire	Par défaut	Remarques
model	string	oui	-	Nom de modèle côté client : `suno-v6`, `suno-v6-wild` ou `suno-v6-mini`
originalTags	string	non	-	Étiquettes de style d'origine
original_tags	string	non	-	Alias compatible de `originalTags`
style	string	non	-	Étiquettes de style d'origine ; alternative à `originalTags`
instrumental	boolean	non	false	S'il faut renforcer dans une direction instrumentale
lyrics	string	non	-	Paroles complètes ; une fois fournies, une description de style est générée à partir de leur contenu
user_guidance	string	non	-	Demande en langage naturel de l'utilisateur, par exemple « ajoute du suona et de l'erhu, voix masculine, tempo plus rapide » ; la plateforme a un champ du même nom et le transmet tel quel

Exemple de requête

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nLa nuit tombe derrière la fenêtre\n[Chorus]\nNous marchons vers la lumière",
    "user_guidance": "ajoute du suona et de l\u0027erhu, voix masculine, tempo plus rapide",
    "instrumental": false
  }'

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle est la description de style complète à réécrire dans le champ Style.

SuivantAPI de suggestions de prompt

Obtenir une clé d'API

Créez une clé d'API dans la console après votre inscription. Chaque génération coûte 0,6 ¥ et renvoie 2 pistes, les téléchargements sont illimités et aucun numéro de téléphone n'est requis.

Obtenir une clé d'API Retour à la présentation