Introduction
Suno v6 Mini sur SpicyAPI est une tâche de texte en musique qui renvoie deux versions abouties d’une chanson par requête. Suno le décrit comme une version plus rapide et plus efficace de v6, qui facilite la transformation d’une idée en chanson. Vous envoyez un brief de style dans prompt, éventuellement vos propres lyrics, et recevez deux MP3. Il coûte ici le même tarif unique que v6 et v6 Wild.
Fonctionnalités et points forts
Une idée en entrée, une chanson en sortie
Écrivez une phrase et laissez lyrics vide : avec generate_lyrics activé (le réglage par défaut), le modèle écrit les mots et les chante. Lors de notre test, il a écrit environ trois minutes et demie de paroles et a chanté chaque ligne dans l’ordre.
La même gestion des paroles
Apportez vos propres mots et v6 Mini les chante tels qu’écrits. Les paroles de 11 lignes utilisées sur les trois modèles sont revenues mot pour mot et dans l’ordre, avec les balises [Verse] et [Chorus] restées silencieuses.
Une paire de prises
Chaque requête renvoie deux versions, qui peuvent différer en durée. Le tarif unique couvre les deux : un brouillon rapide coûte donc le même prix, quelle que soit la durée de la chanson.
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
Esquisser des chansons vite
Utilisez-le comme un carnet : tapez l’accroche, écoutez-la, réécrivez-la. De courtes paroles donnent des chansons d’environ une minute et demie.
Styles doux, acoustiques et lounge
Des briefs folk, indé et jazz avec une poignée d’instruments nommés, voilà ce que nous avons généré pour nos exemples, d’une chanson folk en picking à un instrumental lounge enfumé.
Guide de prompt et conseils pratiques
Gardez le brief court et concret
Nommez le genre, le tempo en bpm et deux ou trois instruments, par exemple « acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar ». Les noms de vrais artistes sont refusés.
Laissez-le écrire, puis reprenez la main
Partez d’une idée et lisez les paroles choisies par le modèle. Copiez celles qui vous plaisent dans lyrics, modifiez-les et relancez pour qu’elles soient chantées exactement comme vous les avez écrites.
Sachez ce que le filtre arrête
Suno refuse les paroles et descriptions au-delà du niveau Léger en quelques secondes, sans facturation. Les paroles de niveau Léger et les termes forts ont été chantés.
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-mini/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.
