Suno API : statut officiel, clés d'API et exemple en Python

Au 17 octobre 2026, Suno dispose d'une API officielle, mais on ne peut pas s'y inscrire : platform.suno.com n'affiche qu'une connexion pour les comptes API existants, sans documentation publique, sans tarifs et sans accès en libre-service, et Suno a indiqué en juillet commencer avec un groupe sélectionné de partenaires. Sans invitation, deux autres solutions fonctionnent aujourd'hui.

Existe-t-il une API Suno officielle ?

Suno présente une API sur platform.suno.com, et l'ensemble de sa façade publique tient en une seule adresse.

Le titre promet « original songs, covers, and mashups from a single prompt » derrière « a simple REST API », et la seule action de la page consiste à se connecter avec le compte Google lié à votre compte Suno ou avec un code envoyé par e-mail. Ses autres liens sont suno.com, Terms et Privacy, rien de plus ; /docs et /pricing sur le même domaine renvoient ce même encadré de connexion (vérifié le 17 octobre 2026). L'API existe, mais sa documentation et ses tarifs ne sont visibles qu'après connexion.

L'appel aux partenaires est connu par Music Business Worldwide, qui rapportait le 2 juillet 2026 que le chef produit (CPO) de Suno, Jack Brody, avait annoncé les projets dans une publication LinkedIn le 1er juillet et lié un formulaire de candidature. Le formulaire, tel que le cite l'article, indique : « We're beginning to explore a developer API, starting with a curated group of partners. » Aucune date de lancement n'a été annoncée, et rien sur la page de la plateforme, dans les notes de version ou dans le centre d'aide de Suno n'en ajoute une.

Les acheteurs d'entreprise sont renvoyés vers les ventes : les Conditions d'utilisation de Suno indiquent « if you are an enterprise user, you must contact sales to use our Service ». Le même article note que Suno « has not released self-serve developer access or published its own API documentation », ce qui correspond à ce que la page montre encore en octobre.

Trois façons d'appeler Suno depuis du code aujourd'hui

Accès partenaire officiel. Le formulaire que Brody a lié en juillet est la seule porte que Suno ait montrée, et l'article décrit un accès anticipé pour un groupe sélectionné de partenaires plutôt qu'une inscription ouverte. Le 17 octobre 2026, la page de la plateforme ne porte que l'encadré de connexion, sans formulaire, liste d'attente ni lien de demande d'accès, et nous n'avons trouvé aucun lien public vers le formulaire sur les pages de Suno. Music Business Worldwide ne donnait aucun calendrier pour un lancement plus large.

Le wrapper GitHub non officiel. gcui-art/suno-api est le contournement le plus connu : 3 259 étoiles et environ 100 issues ouvertes au 17 octobre 2026, le dernier commit datant du 6 mars 2026. Son README indique que l'API officielle « is not yet available » et demande trois choses : le cookie de votre propre compte Suno, copié à la main depuis l'onglet réseau du navigateur ; une clé 2Captcha payante, car Suno continue de servir des défis hCaptcha ; et un vrai navigateur piloté via Playwright avec les correctifs rebrowser. L'issue #262, ouverte le 14 décembre 2025, cite l'auteur : « lacks the time to maintain it ».

Les Conditions d'utilisation de Suno, révisées le 10 août 2026 et en vigueur le 3 septembre 2026, interdisent « any data mining, robots, scraping, or similar data gathering or extraction methods » et interdisent aussi d'obtenir du contenu « through any means not intentionally made available or provided for through the Service ». Lisez ces deux clauses dans les Conditions de Suno avant de bâtir un produit sur un wrapper qui pilote suno.com avec votre propre cookie. Le README ne contient aucun avertissement à ce sujet ; sa seule mention légale est la licence LGPL-3.0.

Une plateforme d'API tierce. OmniaKey est une plateforme d'API tierce, pas Suno. Elle vend un accès API à Suno v4.5 et Suno v6 via sa propre API média asynchrone, avec une clé qu'OmniaKey émet et facture. Sa documentation liste exactement deux identifiants de modèle, suno-v4.5 et suno-v6, et chaque requête renvoie un morceau terminé et mixé, alors qu'un compte Suno vous montre deux alternatives. C'est l'option que nous avons exécutée de bout en bout ci-dessous.

Générer une chanson en Python

Une requête crée une tâche, un second appel vérifie son état, et le MP3 terminé arrive sous forme de lien signé. Exportez votre clé, enregistrez le script sous suno_song.py et lancez-le ; le script interroge status toutes les 5 secondes, car progress.percent est indicatif et peut rester à 0 pendant que la tâche tourne.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Créer la tâche. Réutiliser la même Idempotency-Key uniquement pour réessayer cette requête précise.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Interroger status, pas progress.percent, jusqu'à la fin de la tâche.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Télécharger le MP3 maintenant : l'URL signée expire dans environ une heure.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Nous avons exécuté ce script le 17 octobre 2026 et il a affiché deux lignes.

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

Du démarrage à l'enregistrement du fichier, il a fallu 82 secondes. Le fichier est un MP3 stéréo 48 kHz d'environ 161 kbps, de 2:55, 3,5 Mo, et instrumental parce que le script met instrumental à true.

Pour comparer les deux modèles dans les deux modes d'entrée, nous avons aussi créé quatre chansons via l'API d'OmniaKey le 17 octobre 2026, à partir de 13:03 UTC, en interrogeant toutes les 4 secondes.

Les quatre ont abouti du premier coup et chaque requête a renvoyé un MP3. Une description a produit une chanson complète d'environ trois minutes ; le même style avec huit lignes de paroles écrites par nous est revenu en 45 à 63 secondes, prévoyez donc un morceau court quand vous écrivez vos paroles. Les débits allaient de 151 à 195 kbps en stéréo 48 kHz, et les liens de téléchargement signés expiraient environ une heure après la création de chaque tâche.

Paramètres et limites

• Un input.lyrics non vide bascule en mode paroles personnalisées, où input.prompt, parameters.style ou parameters.tags décrivent le style ; une tâche sans prompt ni paroles est refusée.
• suno-v6 se choisit par l'identifiant de modèle et n'a pas besoin de mv, tandis que mv ne s'applique qu'à v4.5.
• Seul generate est servi. Prolonger, générer uniquement les paroles et la synthèse vocale échouent avec 503 no_available_channel, et le pré-débit est remboursé.
• Une requête correspond à une chanson terminée, donc parameters.n doit valoir 1.
• Les liens des fichiers sont signés et de courte durée, environ une heure, et les enregistrements de tâches sont conservés 24 heures après leur création.

Erreurs et remboursements

Une tâche qui échoue, est annulée ou n'atteint jamais le fournisseur est remboursée automatiquement, et une tâche annulée qui se termine quand même est facturée selon l'état dans lequel elle finit. Renvoyer la même clé d'idempotence avec le même corps renvoie la tâche d'origine avec un 200 au lieu de créer une seconde tâche, donc une nouvelle tentative après un délai d'attente n'est facturée qu'une fois. La reprise est courte : si la création expire, renvoyez le même corps et la même clé ; une fois que vous avez un identifiant de tâche, continuez à l'interroger.

Questions fréquentes

Existe-t-il une API Suno gratuite ?

Suno ne publie aucun palier d'API gratuit sur platform.suno.com. Les offres gratuites se trouvent dans l'application suno.com : v6-mini est ouvert à tous et la variante v4.5-all est gratuite depuis le 21 octobre 2025. Ce qui est produit avec l'offre gratuite est réservé à un usage personnel et non commercial.

Puis-je utiliser commercialement des chansons issues d'une API Suno ?

Les Conditions de Suno attribuent l'Output aux abonnés Pro et Premier, et n'autorisent l'usage commercial que pour l'Output « downloaded by you through an approved channel ». L'Output de l'offre gratuite reste non commercial, et les remixes sont réservés à un usage personnel quel que soit votre forfait. Les chansons issues d'une API tierce ne font pas exception, lisez donc les Conditions de Suno avant de placer une chanson générée dans un produit payant.

Combien de temps prend une chanson ?

La documentation audio situe une génération entre vingt secondes et deux minutes. Nos quatre tâches ont pris de 70 à 105 secondes, et l'exécution du script a pris 82 secondes du démarrage à l'enregistrement du fichier.

Faut-il choisir v4.5 ou v6 ?

Suno a annoncé la famille v6 le 9 septembre 2026 et v4.5 le 1er mai 2025. v6 se choisit par le seul identifiant de modèle, tandis que v4.5 accepte parameters.mv pour fixer une version, et l'identifiant suno-v4.5 d'OmniaKey ne dit pas à quelle variante de v4.5 il correspond. Suno appelle v6 son modèle phare, commencez donc par Suno v6 sauf si vous devez fixer une ancienne version de v4.5.

Comment obtenir une clé d'API Suno ?

Si vous avez déjà un compte API, connectez-vous sur platform.suno.com avec le compte Google lié à votre compte Suno ou avec un code envoyé par e-mail. Sans compte, le formulaire partenaire de juillet était la seule porte publique, et il n'est plus sur la page aujourd'hui. Une plateforme tierce comme OmniaKey émet sa propre clé, distincte de toute connexion à Suno.