Documentation de l’API Suno — générer de la musique à partir d’un prompt (V5 / V5.5), avec tarification

Suno est un modèle d’IA musicale de premier plan : il génère des chansons complètes avec voix, paroles et instrumentation à partir d’une invite textuelle. L’API Suno (Suno V5 et V5.5 sur Kunavo) exécute cette opération par programmation via POST /v1/audio/music et renvoie des pistes audio hébergées avec un seul jeton bearer. Voici la documentation pratique : structure de la requête, tarification et modèle asynchrone pour la production.

Appeler l’API Suno

Générez une clé sur /app/keys et envoyez une requête POST avec une invite. Une requête renvoie environ deux variantes de piste ; la génération prend de quelques dizaines de secondes à quelques minutes :

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

Les paramètres complets et le cycle de vie asynchrone des tâches figurent dans la référence de l’API musicale.

Tarification

Suno est facturé par requête de génération (et non par piste) : les ~2 variantes renvoyées coûtent donc une seule unité de facturation. Les tarifs actuels figurent sur chaque page de modèle. Suno ne publie aucun tarif API par requête — sa propre API est un programme réservé aux partenaires, sans tarifs publics — le tableau indique donc uniquement ce que facture Kunavo.

Paiement à l’usage à partir d’un rechargement minimum de $10, solde sans expiration et générations échouées jamais facturées. Estimez une charge plus large avec le calculateur de coûts.

Mode personnalisé : vos propres paroles

Au lieu d’une invite simple, fournissez lyrics, une description style et un title pour un contrôle total, ou définissez instrumental: true pour ignorer entièrement les voix :

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

Asynchrone en production

La génération musicale n’est pas instantanée. À grande échelle, soumettez donc une tâche et interrogez le résultat plutôt que de maintenir la connexion ouverte — la documentation musicale couvre le cycle de vie des tâches, l’interrogation et la livraison par webhook. Les URL de résultat sont permanentes une fois la génération terminée.

Kunavo par rapport à l’utilisation directe de Suno

Le produit propre de Suno est un abonnement avec une allocation de crédits, et non une API à l’usage facturé au compteur — c’est précisément pourquoi les développeurs recherchent une « API Suno » :

Si vous générez de la musique dans un produit, la facturation au compteur et un véritable endpoint sont essentiels. Si une personne utilise un navigateur pour créer manuellement des pistes, l’abonnement propre de Suno est l’achat le plus simple.

API Suno et API Udio

Udio est l’autre grande famille de génération musicale, et « API Udio » est une recherche parallèle courante. La différence pratique aujourd’hui : l’accès à l’API Udio passe par des voies tierces expérimentales sans prix public stable, tandis que Suno V5 / V5.5 sur Kunavo est un endpoint pris en charge avec un tarif fixe publié ($0.09 par requête de génération). Si vous avez besoin d’une génération musicale fiable en production, l’API Suno V5 proposée ici est la voie fiable ; nous évaluerons Udio lorsqu’un fournisseur amont stable existera.

Au-delà de la musique

La même clé donne accès au texte (Claude, GPT), aux images (Nano Banana, GPT-Image-2) et à la vidéo (Veo 3, Seedance 2, Wan 2.7), ce qui vous permet d’enchaîner un pipeline complet : écrire le script avec un LLM, générer les visuels, puis ajouter une bande-son Suno. Consultez le guide de l’IA multimodale pour les workflows image → vidéo → musique.

Questions fréquentes