Suno V6 API : choisir une version et migrer son code

La Suno V6 API sur reAPI conserve le point d'entrée audio existant avec version: "V6", "V6_MINI" ou "V6_WILD". Pour une ancienne intégration, vérifiez la version et les noms des champs : l'interface Suno utilise désormais snake_case. Une ancienne version peut passer la validation puis échouer pendant la génération.^[1]

Commencez avec model: "suno-music" et une version V6 explicite. Conservez l'envoi et l'interrogation asynchrones, puis enregistrez les identifiants des pistes pour les modifications ultérieures. Mettez d'abord à jour la construction des requêtes, puis la lecture des résultats terminés. Remplacer le nom du modèle par suno-v6 n'est pas la méthode documentée pour sélectionner V6.

À retenir

• Envoyez V6, V6_MINI ou V6_WILD dans version ; gardez suno-music comme identifiant de génération de chansons.^[1]
• Remplacez les champs camelCase par les noms snake_case documentés, notamment custom_mode, negative_tags et audio_id.^[1]
• N'envoyez plus les versions retirées V4–V5.5. Une validation réussie ne signifie pas que le modèle produit encore de l'audio.^[1]
• Partez de V6 pour une direction musicale définie, évaluez Mini si l'attente compte et Wild pour explorer. Ces choix viennent des descriptions de Suno, sans garantie de performance mesurée.^[2]
• Prévoyez $0.06 par génération de chanson terminée, deux prises comprises. Les effets sonores ont un tarif distinct de 13 crédits.^[3]

Ce qui change dans une requête Suno V6 API

Suno a annoncé V6 le 9 septembre 2026, avec trois variantes et une transition depuis sa génération précédente de modèles.^[2] Pour un développeur, il faut d'abord distinguer les fonctions annoncées du produit des champs réellement disponibles dans l'intégration.

L'annonce décrit des possibilités de création et d'édition plus larges. Elle ne rend pas chaque fonction grand public accessible dans une requête audio reAPI. La génération actuelle documente des commandes textuelles et les traitements audio correspondants. N'ajoutez pas de champ image ou vidéo simplement parce que l'annonce évoque ces entrées. Implémentez selon la référence complète des paramètres Suno.^[1]

La référence Suno V6 présente le format actuel. model désigne l'opération ; version désigne le modèle musical qu'elle utilise. Séparez ces deux choix pour que sélectionner Mini ne remplace pas accidentellement une génération par une opération d'édition.^[4]

Il s'agit ici du service reAPI. Le formulaire public de Suno destiné aux développeurs décrit toujours une exploration avec des partenaires sélectionnés. Il ne délivre pas de clé de production en libre-service.^[5]

V6, Suno V6 Mini et Suno V6 Wild : quelle valeur envoyer

Choisissez selon ce que vous attendez du prochain résultat. Suno présente son modèle principal comme axé sur la précision, Wild sur une exploration moins prévisible et Mini sur une création plus rapide et efficace. Le tableau applique ces descriptions à des décisions pratiques.^[2]

Mini n'est pas un niveau API moins cher. Une même opération coûte autant avec les trois variantes. Un résultat plus rapide ferait donc gagner du temps, sans réduire le tarif affiché de cette requête.^[4] Nous n'avons effectué ni comparaison contrôlée de latence ni test d'écoute comparatif pour cet article. Considérez « plus rapide » comme le positionnement de Suno jusqu'à mesurer vos propres traitements.

Pour comparer équitablement, gardez le prompt, le mode et les autres réglages identiques ; changez seulement version. Évaluez les deux prises. Si vous modifiez aussi les paroles ou le style, vous ne pourrez pas attribuer la différence à un changement précis.

Enregistrez la version avec chaque tâche. La documentation des extensions demande qu'elle corresponde à la piste source. Le sélecteur des nouvelles chansons ne doit donc pas écraser silencieusement la version des requêtes d'extension suivantes.^[1]

Suno V6 face à V5.5 : migrer les versions et les champs

Pour une intégration existante, la première question dans Suno V6 face à V5.5 est de savoir si la requête peut encore aboutir. reAPI indique que V4, V4_5, V4_5PLUS, V4_5ALL, V5 et V5_5 sont retirés. Le schéma conserve ces valeurs, mais la génération échoue et fait l'objet d'un remboursement.^[1]

Deux moments d'échec sont donc possibles. Un champ non pris en charge peut être refusé dès l'envoi. Une ancienne version acceptée peut créer une tâche qui échoue ensuite. Vérifier uniquement le statut HTTP du POST ne détecte pas le second cas.

Examinez les préréglages enregistrés et les valeurs par défaut du serveur, pas seulement le sélecteur visible. L'application peut afficher « V6 » alors qu'un processus en arrière-plan continue d'envoyer un ancien payload.

La référence complète signale le changement de noms du 13 septembre 2026.^[1] Modifiez l'objet de requête de façon ciblée. Un remplacement de texte global dans les résultats stockés et d'autres intégrations risque de toucher des éléments qui ne sont pas concernés.

Pour les nouvelles tâches, générez d'abord une source V6 valide, puis testez les modifications qui en dépendent. Sélectionner V6 ne rend pas automatiquement chaque ancien identifiant de piste compatible avec toutes les opérations.

Les huit opérations de la page V6

La page dédiée à V6 couvre huit opérations. Elles partagent POST /api/v1/audio/generations, mais leurs entrées obligatoires diffèrent.^[4]

La famille complète comporte 18 opérations asynchrones. Les dix autres sont hors de cette page ; cela ne signifie pas qu'elles refusent toutes une version. suno-replace-section accepte soit task_id avec audio_id pour une piste existante, soit upload_url avec version. La branche d'import exige la version ; celle d'une piste existante doit l'omettre. Mélanger les branches est invalide.^[1]

Si votre code ajoute globalement version à toutes les requêtes Suno, retirez cette hypothèse. Ne choisissez une version que dans les constructeurs concernés. La conversion WAV, les paroles et les opérations vocales ont également leurs propres contrats d'entrée et de sortie.

Envoyer une première requête V6 et attendre l'audio

Il vous faut une clé reAPI, suffisamment de crédits pour l'opération et un emplacement serveur pour protéger le secret. Le mode inspiration simplifie le premier payload : prompt décrit la chanson et le modèle écrit les paroles.^[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

Lisez l'id de la tâche retournée, puis utilisez-la dans le point d'entrée des tâches. TASK_ID ci-dessous est un emplacement à remplacer par cette valeur réelle :

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

Un envoi réussi ne signifie pas que l'audio est prêt. Continuez les interrogations tant que la tâche attend ou s'exécute, arrêtez en cas d'échec, et exploitez la sortie lorsque status vaut completed. Le polling ne consomme pas de crédits.^[4]

Pendant la préparation, nous avons exécuté une génération V6 dans le playground de production. La réponse finale contenait deux entrées dans output.audio_urls et deux dans output.tracks. Cela confirme le nombre de sorties de cet exemple ; ce n'est pas un benchmark de performance ou de fiabilité.

Enregistrez chaque output.tracks[].id, s'il est présent, avec l'identifiant de la tâche parente. Une URL audio ne remplace pas audio_id. La référence garantit l'URL de la piste, mais les métadonnées vides peuvent être omises. Gérez explicitement l'absence de paroles, de durée ou d'identifiant avant d'activer une action ultérieure.^[4]

Pour imposer les paroles, passez au mode personnalisé et fournissez aussi style et title. Le paramètre de version Suno V6 ne change pas le sens de custom_mode : la durée est prise en compte dans ce mode, avec une cible entière de 10 à 360 secondes.^[4]

Le prix d'un appel V6

Le tarif Suno V6, consulté le 14 septembre, indique $0.06, soit 60 crédits, par requête de chanson terminée. Les deux prises sont incluses. Diviser par deux donne $0.03 par piste retournée ; c'est une répartition arithmétique, pas un tarif à la piste achetable séparément.^[3]

Si vous ne retenez qu'une prise, votre chanson utilisable coûte toujours $0.06. Une nouvelle génération ou une opération suivante ajoute son propre coût. Choisir Mini ou demander une chanson plus courte dans la plage autorisée ne réduit pas ce prix.^[4]

Les effets sonores sont différents : leur prix brut affiché est $0.0125, mais le débit en crédits entiers est de 13 crédits, soit $0.013. Pour le budget, prenez le montant débité plutôt que d'arrondir le tarif brut à la baisse.^[3]

Configurez vos identifiants avec le guide de la clé API Suno. La grille tarifaire complète couvre les autres opérations ; le guide du statut officiel traite séparément la question de l’accès.

Questions fréquentes

Suno V6 est-il disponible via une API ?

reAPI documente V6, V6 Mini et V6 Wild dans son API de tâches audio. Ce service est distinct de la candidature développeur de Suno.^[4][5]

Quelle différence entre les trois variantes ?

Suno présente V6 pour la précision, Mini pour une création plus rapide et Wild pour l'exploration. Choisissez avec vos propres critères ; aucune différence de performance chiffrée n'est affirmée ici.^[2]

Les variantes ont-elles le même prix ?

Oui, pour une même opération reAPI. La génération d'une chanson coûte $0.06 par requête terminée pour chaque variante.^[3][4]

Puis-je encore envoyer V5_5 ?

Le schéma l'accepte, mais le parcours documenté échoue puisque cette version est retirée. Utilisez une valeur V6 actuelle pour les nouvelles tâches.^[1]

Quelles fonctions V6 imposent une modification du code ?

Vérifiez la sélection de version, les champs snake_case et les entrées propres à chaque opération. Les fonctions grand public annoncées ne deviennent pas automatiquement des paramètres de requête.^[1]

version est-il facultatif ?

Parmi les huit opérations V6, uniquement pour suno-add-vocals et suno-add-instrumental, qui utilisent V6 par défaut. Générer une chanson exige une valeur explicite.^[4]

Quelle durée peut-on demander ?

La cible duration du mode personnalisé est de 10–360 secondes. Elle ne s'applique pas au mode inspiration.^[4]

Toutes les opérations renvoient-elles deux chansons ?

Non. L'exemple de facturation à deux prises concerne la génération de chansons. Les paroles, WAV, séparations et autres opérations ont des sorties distinctes à traiter selon leur type.^[1]

Migrer la requête et conserver l'identité des pistes

Commencez par une requête avec une version actuelle et suivez-la jusqu'au bout. Vérifiez le JSON envoyé, sauvegardez les identifiants de tâche et de pistes, puis testez la prochaine opération réellement utile à votre application. Ce parcours complet, gestion des échecs comprise, constitue le bon test d'acceptation d'une migration Suno V6 API.

Références

1. reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
2. Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
3. reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
4. reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
5. Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.