Introduction
Suno v6 sur SpicyAPI est une tâche de texte en musique qui renvoie deux versions abouties d’une chanson par requête, chacune un MP3 complet avec voix et accompagnement. Vous décrivez le style dans prompt et, si vous en avez, placez les mots à chanter dans lyrics. D’après Suno, v6 est son modèle fiable et précis, et lors de nos tests il a chanté des paroles mot pour mot, dans l’ordre. Un tarif unique couvre toute la requête.
Fonctionnalités et points forts
Deux prises à chaque fois
Chaque requête renvoie deux versions complètes de la chanson. Ce ne sont pas des extraits l’une de l’autre : elles peuvent différer par l’arrangement et la durée, et vous gardez celle qui vous plaît. Le tarif unique couvre les deux.
Vos paroles, chantées comme écrites
Des paroles de 11 lignes sont revenues chantées ligne par ligne, dans l’ordre où nous les avions écrites. Les balises de section comme [Verse] et [Chorus] ont structuré la chanson sans être chantées, et le refrain n’est pas revenu sauf si les paroles le répétaient.
Trois façons de gérer les mots
Apportez vos propres paroles, laissez le modèle les écrire à partir de prompt (generate_lyrics est activé par défaut) ou activez instrumental pour une chanson sans voix. Les réglages fins comme title, vocal_gender, style_weight, weirdness, variety et les personas s’appliquent quand vous apportez vos propres paroles ou passez en instrumental.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Le brief de style. Avec vos propres paroles ou instrumental activé, il ne décrit que le style : genre, tempo, instruments, voix, ambiance, jusqu’à 1 000 caractères. 1 caractères minimum · 3000 caractères maximum |
lyrics | Non | Les mots à chanter, jusqu’à 5 000 caractères, une ligne par rangée. 1 caractères minimum · 5000 caractères maximum |
generate_lyrics | Non | Activé par défaut : quand lyrics est vide et instrumental désactivé, le modèle écrit les paroles à partir de prompt. Les paroles que vous fournissez ne sont jamais réécrites. Valeur par défaut: |
instrumental | Non | À activer pour un morceau sans voix. prompt décrit alors le style (jusqu’à 1 000 caractères) et lyrics n’est pas nécessaire. Valeur par défaut: |
title | Non | Titre de la chanson, jusqu’à 80 caractères. S’applique avec vos propres paroles ou avec instrumental activé ; avec des paroles générées, le modèle choisit le titre. 1 caractères minimum · 80 caractères maximum |
negative_prompt | Non | Styles, sons ou ambiances à écarter de la chanson, sous forme de courte liste séparée par des virgules, par exemple « harsh distortion, spoken word ». Facultatif. 1 caractères minimum · 500 caractères maximum |
vocal_gender | Non | Oriente la voix principale vers le féminin ou le masculin. C’est une préférence, pas une garantie, et nous n’avons pas testé à quelle fréquence elle est respectée. |
style_weight | Non | Degré de fidélité de la chanson à votre brief de style, de 0 à 1 par pas de 0,01. |
weirdness | Non | Distance que la chanson peut prendre avec l’attendu, de 0 (classique) à 1 (aventureux), par pas de 0,01. S’applique uniquement avec vos propres paroles ou instrumental activé. |
audio_weight | Non | Poids de l’audio fourni en entrée dans le résultat, de 0 à 1 par pas de 0,01. Suno ne le prend pas en charge pour les chansons sans voix. |
variety | Non | Dans quelle mesure le modèle fait varier votre prompt de style, sous forme d’entier de 0 (désactivé : vos balises de style sont utilisées exactement comme écrites) à 4 (maximum). |
persona_id | Non | L’identifiant d’une persona ou d’une voix Suno enregistrée, chargée de chanter ou de jouer la chanson. Facultatif. 1 caractères minimum · 200 caractères maximum |
persona_model | Non | Indique au modèle ce qu’est |
image_urls | Non | Jusqu’à 5 images d’ambiance (JPEG, PNG, WebP ou BMP, 10 Mo maximum chacune) dont le modèle s’inspire pour l’atmosphère de la chanson. 5 éléments maximum |
reference_video_urls | Non | Une vidéo de référence (MP4, MOV ou WebM, jusqu’à 100 Mo et 241 secondes) autour de laquelle la chanson est construite, par exemple pour l’illustrer en musique. 1 éléments maximum |
reference_audio_urls | Non | Un fichier audio de référence (de 6 secondes à 30 minutes, jusqu’à 500 Mo) qui inspire la chanson. 1 éléments maximum |
Tarification
$0.072 / requête
Un tarif unique par requête, qui couvre les deux versions de la chanson, quelle que soit leur durée.
Cas d’utilisation
Des chansons que vous avez déjà écrites
Poèmes, toasts, jingles et chansons à histoire : gardez le texte, choisissez le genre et la voix, puis comparez deux versions. Les chansons ont duré d’environ une minute et demie pour de courtes paroles à plus de deux minutes pour des paroles complètes.
Une musique qui suit une image ou un clip
Avec des paroles générées, vous pouvez envoyer jusqu’à 5 images d’ambiance, une vidéo de référence ou un audio de référence, et le modèle écrit une chanson autour. Pour un fond sonore sans paroles, activez instrumental.
Guide de prompt et conseils pratiques
Décrivez le son, pas l’artiste
Écrivez le genre, le tempo en bpm, deux ou trois instruments et le type de voix : « soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano ». Les prompts qui citent de vrais artistes sont refusés ; décrivez donc le son.
Balisez les sections
Placez [Intro], [Verse], [Chorus], [Bridge] et [Outro] sur leur propre ligne et répétez le texte du refrain là où vous voulez qu’il revienne. Plus de lignes donnent une chanson plus longue ; il n’existe pas de réglage de durée.
Sachez ce que le filtre arrête
Suno refuse en quelques secondes les paroles et descriptions les plus fortes, sans les facturer. Les paroles plus douces et les termes crus sont chantés ; gardez donc votre écriture de ce côté de la ligne.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
