APIMart
APIMart

Comment utiliser Suno v5.5 : chansons et voix IA

Un guide pas à pas de Suno v5.5— configurer l'accès, générer des chansons par mode, gérer les voix, prolonger les clips, stocker les fichiers et vérifier les droits commerciaux sur la musique.

Tutoriel

Suno a remplacé v5.5 par ses modèles V6 le 9 septembre 2026, mais le flux décrit dans ce guide reste valable : envoyer une invite texte, interroger la tâche, puis faire passer le fichier en revue, en stockage et en publication. Avec la Suno API d'APIMart, vous appelez désormais v6, v6-wild ou v6-mini au lieu de v5.5 (Suno : Introducing v6).

Si je devais résumer ce guide, cela reviendrait à ceci :

  • Je configure l'accès à l'API avec une clé, des en-têtes et du polling

  • Je choisis le bon mode : description, paroles personnalisées ou musique seule

  • Je façonne le résultat avec de courtes invites, des indications vocales et l'extension de clip

  • Je fais passer les brouillons par les stems, le mixage, l'export et l'approbation

  • J'enregistre les fichiers rapidement, car APIMart ne conserve les résultats que 72 heures

  • Je vérifie les droits commerciaux, les registres de consentement et les journaux d'approbation avant la publication

Ce guide s'adresse surtout à celles et ceux qui veulent intégrer la génération de chansons dans un pipeline de contenu opérationnel, et pas seulement la tester à la main. Cela inclut les équipes d'applications, les équipes publicitaires, les producteurs de podcasts, les studios de jeux et les monteurs de films.

Quelques chiffres comptent d'emblée :

  • En mode personnalisé, duration accepte 10 à 360 secondes, et la durée finale dépend du résultat

  • Attendre environ 3 secondes avant la première interrogation

  • Le polling se poursuit en général toutes les 5 à 10 secondes

  • Les erreurs de limite de débit comme 429 nécessitent un court délai avant nouvelle tentative

  • Les dates des journaux d'approbation devraient être stockées au format américain, comme 07/16/2026

Ce que j'apprécie dans cette configuration, c'est que le chemin est simple : envoyer la requête → obtenir l'ID de tâche → interroger le statut → télécharger l'audio → le stocker → vérifier les droits.

Voici la version courte du flux de travail :

ÉtapeCe que je fais
AccèsAjouter la clé d'API, l'en-tête d'auth et le corps JSON
GénérationEnvoyer l'invite avec le bon mode et le bon modèle
VoixUtiliser les invites de voix par défaut, les voix clonées ou les flux de voix édités
ÉditionProlonger les clips, séparer les stems, mixer et exporter
RévisionVérifier les paroles, l'usage de la ressemblance et les conditions commerciales
StockageEnregistrer les fichiers MP3/WAV approuvés sur S3, Drive ou un autre emplacement permanent

Autrement dit : il s'agit moins de « faire une chanson » que de construire un système de production musicale reproductible avec des entrées claires, des étapes de révision et une gestion des fichiers.

APIMart
Pipeline musical de l'API [Suno](https://suno.com/home) v5.5 : de l'invite au morceau publié

Points clés

  • Suno a remplacé v5.5 par V6, V6 Wild et V6 Mini le 9 septembre 2026 ; sur APIMart, vous envoyez model: "suno" avec version à v6, v6-wild ou v6-mini.
  • Le flux est asynchrone : POST /v1/music/generations renvoie un ID de tâche, puis vous interrogez GET /v1/music/tasks/{task_id} jusqu'à ce que status soit completed et lisez data.result.music[].audio_url.
  • Le mode inspiration (custom: false) compose la chanson à partir d'une description, le mode personnalisé (custom: true) reprend vos propres paroles avec des balises comme [Verse] et [Chorus], et instrumental: true supprime la voix.
  • Attendez environ 3 secondes avant la première interrogation, puis interrogez toutes les 5 à 10 secondes ; en cas d'erreur 429, patientez un peu avant de réessayer.
  • Le nombre de pistes renvoyées n'est pas fixe et les résultats sont conservés 72 heures : téléchargez tout de suite les fichiers validés, vérifiez les droits d'usage commercial et conservez les consentements pour les voix clonées.

Suno V6 en bref

CaractéristiqueDétails
Type de modèleGénération de chansons par IA via API asynchrone (ID de tâche, puis interrogation du statut)
EntréesPrompt texte ; paroles personnalisées avec balises [Verse]/[Chorus]/[Bridge]/[Outro] ; balises de style ; instrumental: true
SortieUne audio_url par piste dans data.result.music[] dès que status vaut completed ; audio_format peut être mp3, m4a ou wav
Durée du clipduration de 10 à 360 secondes en mode personnalisé ; la durée réelle dépend du résultat
Fonctions clésModes inspiration, personnalisé et instrumental ; vocal_gender ; Personas et modèles personnalisés
DisponibilitéSuno API d'APIMart : model: "suno" plus version (v6 / v6-wild / v6-mini) ou custom_model_id ; authentification par clé API Bearer
Idéal pourJingles publicitaires, chansons de marque, bandes-son pour créateurs, podcasts, musiques de fond
LimitesRésultats conservés 72 heures ; nombre de pistes par tâche non fixe ; les demandes citant des noms d'artistes ou des ressemblances non autorisées peuvent être refusées

Configurer l'accès à Suno V6 pour un projet opérationnel

APIMart

Votre première requête se résume à trois choses : les identifiants, les en-têtes et le polling asynchrone.

Clés d'API, authentification et structure de requête de base

Créez un compte APIMart, puis générez une clé API dans la console. Utilisez des clés distinctes pour les tests et la production afin de pouvoir en renouveler une sans casser l'autre.

Ne codez jamais votre clé en dur dans les fichiers source. Placez-la plutôt dans une variable d'environnement :

SUNO_API_KEY=your_key_here

Pour le travail local, utilisez un fichier .env. En production, utilisez un gestionnaire de secrets comme GitHub Secrets ou AWS Secrets Manager. Sur chaque requête, envoyez ces en-têtes :

  • Authorization: Bearer YOUR_API_KEY

  • Content-Type: application/json

Le flux est simple. Envoyez POST https://api.apimart.ai/v1/music/generations, enregistrez le task_id renvoyé, attendez environ 3 secondes, puis interrogez GET /v1/music/tasks/{task_id} toutes les 5 à 10 secondes jusqu'à ce que status vaille completed ou failed. Une fois terminé, lisez chaque audio_url dans data.result.music[], sans supposer un nombre fixe de pistes. En cas de failed, la raison figure dans data.error.message et le montant est remboursé automatiquement (docs APIMart : générer de la musique, conventions des tâches).

Dès que la piste est prête, téléchargez-la ou déplacez-la vers un stockage permanent, comme un bucket S3. APIMart ne conserve les résultats que 72 heures : l'URL du résultat n'est pas un emplacement durable pour le fichier.

Code d'erreurSignificationQue faire
401Non autoriséVérifiez la clé.
402Paiement requisRechargez votre solde APIMart.
429Limite de débitPatientez un peu, puis réessayez.
502Erreur en amontRéessayez plus tard, mais ne renvoyez pas aveuglément une requête payante après un timeout.

Dans le payload JSON, mettez model à "suno" et choisissez version explicitement : v6 (le modèle phare), v6-wild (résultats plus variés) ou v6-mini (plus rapide). v5.5 n'est plus proposé, car Suno a retiré ses anciens modèles au lancement de V6. Si vous utilisez un modèle personnalisé, envoyez custom_model_id à la place de version ; les deux ne se combinent pas.

Utiliser APIMart comme couche de flux de travail

APIMart

APIMart envoie les requêtes Suno via un seul flux de travail côté serveur, ce qui garde les identifiants hors du code client. En clair, les jetons bruts restent hors du client, et chaque appel passe par la même couche d'intégration.

Dans chaque requête, définissez model et version explicitement pour que la tâche tourne sur la variante V6 que vous avez testée. Une fois l'accès en place, passez à la conception des invites et aux réglages de sortie.

Générer des chansons avec la bonne invite, le bon mode et les bons réglages de sortie

Une fois l'accès configuré, choisissez le mode de génération et le format de sortie avant d'écrire l'invite. Sur APIMart, custom et instrumental sont les deux champs à fixer d'emblée, et audio_format règle mp3, m4a ou wav. Ensuite, vous pouvez affiner les voix et les étapes de revue pour transformer des brouillons en ressources exploitables, comme des bandes-son pour des projets vidéo.

Mode description ou mode paroles personnalisées

Le mode description (custom: false) laisse l'IA écrire les paroles et choisir le style musical à partir d'une courte invite textuelle. C'est idéal quand vous voulez une sortie rapide avec une direction légère. Le mode paroles personnalisées (custom: true) vous met aux commandes. Vous fournissez les paroles exactes, des balises de section comme [Verse], [Chorus], [Bridge] et [Outro], ainsi que des détails de style tels que le genre, l'ambiance et le tempo. Cela le rend plus adapté aux publicités, aux chansons de marque et aux morceaux de créateurs avec une structure définie.

ModeVitesseContrôleCas d'usage le plus adaptéEntrée requise
DescriptionLe plus rapideFaible (piloté par l'IA)Pistes d'arrière-plan, beats lo-fi, mise en ambianceCourte invite descriptive
Paroles personnaliséesPlus lentÉlevé (défini par l'utilisateur)Jingles publicitaires, chansons de marque, narrationParoles complètes + balises de style + titre
InstrumentalRapideMoyenPodcasts, transitions vidéo, nappes d'ambianceBalises de style + instrumental: true

Si vous voulez une sortie uniquement instrumentale, définissez instrumental: true. Utilisez ensuite negative_tags pour bloquer les voix que vous ne voulez pas, comme "vocals, singing, voice".

Modèles d'invite pour les publicités, la musique de marque et le contenu de créateur

Un modèle d'invite simple fonctionne bien ici : [genre] [mood] [instruments] [voice] [era/influence]. En pratique, une invite courte avec quelques termes clairs garde le modèle sur la bonne voie mieux qu'une longue liste. Trop de signaux mélangés peuvent le déstabiliser.

Le mode doit correspondre à la tâche. Utilisez le mode description quand vous visez une atmosphère. Utilisez le mode paroles personnalisées quand la chanson doit porter un message, une accroche de marque ou une histoire. Vous pouvez aussi préciser directement la texture vocale avec des expressions comme "soft female vocals", "deep male baritone" ou "ethereal" pour garder le son aligné sur un ton de marque ou un style de chaîne.

Planifier la sortie pour un usage en production

Pour maîtriser la durée, définissez duration (10 à 360 secondes) en mode personnalisé et vérifiez la duration réelle dans le résultat, car la cible n'est pas garantie. Pour prolonger une piste existante, utilisez l'endpoint de continuation POST /v1/music/generations/extend (docs APIMart : continuation et extension). Ajouter un [Outro] dédié ou un marqueur de fin clair aide la piste à se terminer proprement.

Pour le travail de production, générez plusieurs versions, téléchargez chacune immédiatement et enregistrez une version instrumentale à côté de chaque piste vocale. Cela vous donne un plan B si une version vocale ne convient pas à la publicité, au montage ou à la révision finale. Il est aussi utile de stocker chaque ressource avec son invite et ses métadonnées dans un dossier de projet cohérent.

Ensuite, affinez les voix et les étapes d'édition pour que la meilleure version soit prête pour la révision.

Gérer les voix, les étapes d'édition et les contrôles de flux de travail commercial

Voix par défaut, voix clonées et flux de voix personnalisées

Suno V6 vous offre trois flux de travail vocaux, et choisir le bon dès le départ peut vous épargner beaucoup de nettoyage plus tard.

Les voix par défaut sont la voie la plus rapide. Vous décrivez le style vocal dans votre invite — quelque chose comme soft female vocals, ethereal ou deep male baritone — et le modèle se charge du reste. Cette option fonctionne bien pour des brouillons commerciaux rapides quand vous n'avez pas besoin d'une identité vocale fixe.

Les voix clonées demandent plus de préparation, mais elles vous donnent un son stable et reconnaissable. N'utilisez les voix clonées que lorsque vous disposez d'un consentement clair et documenté du propriétaire de la voix.

Les workflows de voix personnalisée vont plus loin. Chez Suno, les Personas sont réservées à l'offre Premier, tandis que les modèles personnalisés existent en Pro et en Premier (tarifs Suno). Via APIMart, vous passez persona_id (mode personnalisé uniquement) ou custom_model_id, qui ne peuvent pas figurer dans la même requête (docs APIMart).

Type de voixCohérence de marqueEffort de préparationBesoins de gouvernance
Voix par défautBasée sur l'inviteMinimalFaible — droits IA standard
Voix clonéesÉlevée — ressemblance spécifiqueModéré — données d'entraînement requisesÉlevé — consentement et documents juridiques requis
PersonnaliséesTrès élevée — modèles sur mesureÉlevé — édition itérativeModéré — approbation interne requise

Une fois la voie vocale choisie, l'étape suivante est simple : faire passer le brouillon par l'édition et la validation.

Du brouillon de chanson à la ressource utilisable

La première génération est un brouillon. Ce n'est pas la ressource finale.

Le flux de travail ressemble à ceci : brouillon → prolonger → séparer les stems → mixer → exporter.

Commencez par vérifier les paroles et le ton vocal par rapport à votre brief. Séparez ensuite les stems pour que les voix et les instrumentaux se trouvent sur des couches distinctes. Cela donne à votre équipe audio de la marge pour travailler dans un DAW comme FL Studio ou Ableton, où elle peut appliquer EQ, compression et réverbération. Ensuite, exportez la version finale au format WAV et attachez des métadonnées comme le BPM, le genre et les balises de style avant de l'enregistrer dans le dossier de projet.

Étape de productionActionOutils
BrouillonGénérer un clip initial avec une accrocheAPI Suno V6, paroles structurées
ExtensionAtteindre la durée viséeduration en mode personnalisé, ou l'endpoint de continuation POST /v1/music/generations/extend
AffinageSéparer voix et instrumentauxAPI de séparation de stems
Post-productionMixage, EQ, Auto-TuneDAW (FL Studio, Ableton)
ExportConvertir en WAV, attacher BPM et genreÉtiquetage de métadonnées, conversion WAV

Téléchargez immédiatement l'audio approuvé.

Licences, usage commercial et contrôles d'approbation interne

Avant la publication, clarifiez les droits et consignez l'approbation pour chaque morceau terminé.

D'abord, confirmez que le compte utilisé pour générer la chanson inclut des droits d'usage commercial.

Mettez ensuite en place une étape légère d'approbation interne. Signalez toute invite ou tout jeu de paroles mentionnant des noms d'artistes précis ou des ressemblances non autorisées. Les requêtes liées à des ressemblances non autorisées ou à des noms d'artistes peuvent être rejetées. Si vous travaillez avec des ressources de voix clonées, conservez les registres de consentement avec le fichier audio.

Pour le suivi d'audit, consignez l'ID de tâche, le titre de la chanson, la durée, les balises de style et la date d'approbation pour chaque ressource finalisée. Utilisez le format de date américain — comme 07/16/2026 — et notez qui l'a approuvée.

Construire un pipeline musical APIMart de bout en bout

Un pipeline de production simple pour les équipes

Une fois vos choix d'invite, de voix et de licence verrouillés, reliez-les dans un seul flux reproductible : brief en entrée, audio approuvé en sortie, puis stockage pour la vidéo, les publicités ou les réseaux sociaux.

Envoyez le brief à Suno via APIMart. L'API renvoie un ID de tâche, et votre couche d'orchestration — comme n8n — peut exécuter une boucle d'interrogation jusqu'à ce que status revienne à completed ou failed. Attendez environ 3 secondes avant la première interrogation pour éviter les requêtes inutiles.

L'objectif est simple : associer chaque transfert à un outil ou une API pour que le processus se déroule sans que quelqu'un doive courir après les fichiers ou les mises à jour de statut à la main.

Phase du flux de travailOutil / APIAction clé
BriefLLMGénérer paroles et balises de style à partir d'un thème
GénérationAPI de génération Suno (APIMart)Soumettre une requête POST avec invite et mode
Suivi du statutBoucle de polling n8nVérifier le statut de la tâche toutes les 5 à 10 secondes
Révision humaineFormulaire de révisionApprouver ou rejeter avant le stockage
StockageGoogle Drive / S3Télécharger et stocker le MP3/WAV avec métadonnées
ProductionSuite de montageImporter l'audio dans des modèles vidéo ou publicitaires

Un détail compte ici : APIMart conserve les résultats de génération 72 heures. Votre pipeline doit donc télécharger tout de suite les fichiers validés et les placer dans un stockage permanent avant la fin de ce délai.

Une fois le flux de base en place, ajoutez un routage des échecs pour renvoyer les générations rejetées à l'étape de l'invite. Si une tâche se termine en failed, lisez data.error.message, ajustez l'invite et relancez. APIMart rembourse automatiquement les tâches échouées, la file continue donc d'avancer sans se bloquer.

Premiers pas

Commencez par un flux de travail que vous pouvez répéter, puis développez à partir de là seulement après qu'il fonctionne de bout en bout. Choisissez d'abord un cas d'usage — un jingle publicitaire, une piste d'arrière-plan de marque ou une bande-son de créateur.

Avant toute mise en ligne, vérifiez que votre forfait inclut clairement des droits d'usage commercial. Utilisez ensuite APIMart comme la couche qui relie la génération musicale à votre flux de contenu IA plus large, pour qu'une seule requête de chanson puisse traverser un système que votre équipe peut réutiliser encore et encore.

FAQ

Comment choisir entre le mode description, paroles personnalisées et instrumental ?

Choisissez selon le niveau de contrôle que vous voulez.

  • Utilisez le mode description si vous voulez que l'IA compose les paroles et l'arrangement à partir d'une invite textuelle.

  • Utilisez le mode personnalisé si vous voulez fournir vos propres paroles et votre propre structure de chanson.

  • Utilisez le mode instrumental si vous voulez un morceau sans voix, comme de la musique d'arrière-plan ou des jingles.

Que dois-je stocker avec chaque morceau généré pour l'approbation commerciale ?

Conservez un registre clair pour chaque morceau que vous créez. Au minimum, stockez :

  • l'ID de tâche unique

  • le fichier audio final généré

  • des métadonnées telles que le titre de la chanson, la durée et les balises de style ou les invites

  • la version du modèle et la date de création

Ce registre facilite grandement la vérification de la conformité des licences et le maintien d'une piste d'audit pour l'usage commercial.

Comment empêcher les liens audio temporaires d'expirer en production ?

Les résultats de la Suno API sur APIMart ne sont conservés que 72 heures : les liens de résultat ne conviennent donc pas aux ressources de production à long terme.

Voici le geste le plus sûr : dès que votre polling de statut indique que la tâche s'est terminée avec succès, téléchargez le fichier audio immédiatement et envoyez-le vers un stockage persistant.

Cela peut être quelque chose comme :

  • Google Drive

  • Votre système de fichiers local

Si vous attendez trop longtemps, le lien peut expirer et le fichier pourrait avoir disparu quand votre application tente de le récupérer.

Tags#Suno v5.5#Suno API#génération de chansons IA#API de musique#droits commerciaux sur la musique

À propos de l'équipe APIMart

L'équipe APIMart rédige des guides de modèles, des comparatifs et des analyses de prix pour les développeurs qui construisent avec l'IA. APIMart propose une seule API pour les modèles de chat, d'image et de vidéo de plusieurs fournisseurs : vous pouvez comparer les modèles présentés ici avant la mise en production.

Prêt à essayer ?

Choisissez le modèle qui vous convient dans le marketplace

Essayez les modèles de chat, image et vidéo sur le marketplace APIMart, puis découvrez rapidement leurs capacités avec une API unifiée.

Modèles chatModèles imageModèles vidéo
Explorer le marketplace