Obtenir une clé API

par Suno

Chansons complètes avec voix, à partir de tes paroles ou d’une courte idée

suno/v6/text-to-audioÀ partir de 11 créditspar génération · 0,11 $US
  • Jusqu’à 5 images de référence
  • Vos propres paroles
  • Musique
Voir les exemples

À propos de Suno v6

Le modèle phare Suno v6 par API : apportez vos paroles ou une idée en une ligne, décrivez le style et obtenez par requête deux chansons abouties avec voix, ou des instrumentaux. Un tarif unique, quelle que soit la durée.

Appelez-le avec le nom de modèle suno/v6/text-to-audio sur POST /jobs/createTask, à partir de 11 crédits par génération (0,11 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

ParamètreRequisDescription
audio_weightNonHow strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1
generate_lyricsNonLet the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. Par défaut: true
image_urlsNonDes images qui donnent l’ambiance ; la musique s’en inspire.
instrumentalNonMusique seule, sans voix. Par défaut: false
lyricsNonÉcrivez vos propres paroles, ou laissez faire le modèle.
negative_promptNonLes styles ou sons que vous ne voulez pas dans le morceau.
persona_idNonID of an existing Suno persona to reuse its style or voice.
persona_modelNonWhether persona_id is a style persona or a voice persona. style_persona · voice_persona
promptOuiDescribe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it.
reference_audio_urlsNonUn son à reproduire : une voix, une musique ou un rythme.
reference_video_urlsNonUne vidéo sur laquelle la musique doit coller.
style_weightNonHow closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1
titleNonSong title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song.
varietyNonHow different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4
vocal_genderNonMake a female or male lead vocal more likely. Applies with lyrics. female · male
weirdnessNonHow experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1

Tarifs

Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.

OptionCrédits par génération≈ USD
Standard10,80,11 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 11 crédits par génération (0,11 $US).

Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.

Démarrage rapide de l'API

Appeler l’API Suno v6 en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model suno/v6/text-to-audio et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "suno/v6/text-to-audio",
  "input": {
    "prompt": "Calm ambient pads with a slow rising motif"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Suno v6

Combien coûte l’API Suno v6 ?

Suno v6 coûte 11 crédits (0,11 $US) par génération. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.

Quel est le nom de modèle de Suno v6 dans l’API ?

Indiquez suno/v6/text-to-audio pour Musique dans le champ model de POST /jobs/createTask.

Que dit Suno de v6 ?

D’après Suno, v6 est fiable, précis et livre de façon constante une musique aboutie dans tous les genres et tous les styles. Il est sorti le 9 septembre 2026 avec v6 Wild et v6 Mini.

Chantera-t-il exactement mes paroles ?

Dans nos tests avec les réglages par défaut, oui. Une feuille de paroles de 11 lignes a été chantée mot pour mot dans l’ordre écrit ; les balises de section comme [Chorus] n’ont pas été chantées et le refrain n’a pas été répété de lui-même.

Suis-je facturé si une requête est rejetée ou échoue ?

Non. Le montant réservé pour la requête est intégralement libéré.

Puis-je choisir qui chante ?

En partie. Décrivez la voix dans le brief de style, par exemple une voix principale féminine assurée. Avec vos propres paroles ou instrumental activé, vous pouvez aussi régler vocal_gender sur female ou male ; c’est une préférence, pas une garantie, et nous n’avons pas mesuré à quelle fréquence elle est respectée. Un duo demandé dans une idée d’une seule phrase est revenu en solo lors de notre test ; nommez donc une seule voix si cela compte.

Quelles sont les limites de l’API Suno v6 ?

Images de référence: 5; Audio de référence: 1; Vidéos de référence: 1; Longueur du prompt (caractères): 3,000. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer Suno v6 sans écrire de code ?

Oui. Le Playground lance Suno v6 avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

Tous les modèles Suno

Suno v6 est la valeur sûre pour les chansons que tu as déjà en tête. v6 Wild prend des tournures plus surprenantes et texturées, et v6 Mini est le carnet d'esquisses rapide, tous au même prix par lancement.

En savoir plus sur Suno v6