Modèles pris en charge
Modèles de génération disponibles
Les requêtes n'utilisent que les noms de modèles de la plateforme listés ci-dessous.
| Nom du modèle | Nom affiché | Usage | Statut |
|---|---|---|---|
suno-v6 |
Suno V6 | Modèle de génération par défaut | Disponible |
suno-v6-wild |
Suno V6 Wild | Variante Wild du V6 | Disponible |
suno-v6-mini |
Suno V6 Mini | Variante Mini du V6 | Disponible |
Modèle recommandé par défaut : suno-v6.
À propos de la séparation de pistes
La séparation de pistes est une capacité fixe et indépendante : aucun modèle de génération de
morceaux n'est requis. Il suffit d'envoyer le morceau source et le mode de séparation (par
exemple two ou twelve). Le nombre de pistes réellement renvoyées est celui indiqué dans la
réponse.
Le paramètre model
Dans les endpoints de génération, model est généralement facultatif :
- Omis : le modèle par défaut
suno-v6est utilisé. - Fourni : il doit valoir
suno-v6,suno-v6-wildousuno-v6-mini. - Seuls les noms de modèles du tableau ci-dessus sont acceptés.
Exemple minimal de génération
curl -X POST https://www.suno-api.io/api/music/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "une chanson folk entraînante sur le premier jour du printemps",
"model": "suno-v6"
}'
Exemple avec une variante du V6
{
"model": "suno-v6-wild",
"description": "un morceau électronique à la structure expérimentale"
}
Modèles retirés
Ces modèles n'acceptent plus de nouvelles requêtes :
suno-v2suno-v3suno-v3-5suno-v4suno-v4-5suno-v4-5-allsuno-v4-5-plussuno-v5suno-v5-5
Les morceaux et tâches existants peuvent encore afficher l'ancien model_name ou
model_version. Il s'agit de données historiques : cela ne signifie pas que l'ancien modèle
accepte de nouvelles requêtes.
Pour la compatibilité avec d'anciens clients, une requête nommant un modèle retiré est traitée
avec le modèle par défaut suno-v6 au lieu d'être rejetée. La tâche indique également
suno-v6 et aucune erreur « modèle indisponible » n'est renvoyée. Pensez tout de même à mettre
à jour vos exemples vers les noms actuels.
Lister les modèles
GET /v1/models doit inclure au minimum ces modèles de chansons :
{
"object": "list",
"data": [
{ "id": "suno-v6", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
]
}
La réponse peut aussi contenir des modèles de paroles, des routes de compatibilité ou des modèles internes. Ne les confondez pas avec les modèles V6 de génération de chansons.
Choisir entre les variantes V6
La plupart des intégrations se contentent du modèle par défaut. Les trois variantes diffèrent par leur fidélité au prompt et l'ampleur des variations.
| Variante | Quand l'utiliser |
|---|---|
suno-v6 |
Pour un résultat prévisible et fidèle à la description. C'est la valeur par défaut, adaptée à la production. |
suno-v6-wild |
Pour davantage de variations, quand comparer plusieurs prises ne pose pas de problème. |
suno-v6-mini |
Pour tester un prompt à moindre coût avant de générer pour de bon. |
Chaque exécution renvoyant deux pistes, un flux pratique consiste à esquisser avec
suno-v6-mini, puis à relancer le prompt retenu avec suno-v6 pour choisir la version publiée.
Coût et remboursement
La facturation se fait par requête, pas par modèle : chaque exécution coûte 0,6 ¥ et renvoie deux pistes. Une génération en échec est remboursée automatiquement, donc une tentative ratée ne consomme pas de solde. Les téléchargements sont illimités et jamais facturés à part.
Obtenir une clé d'API
Créez une clé d'API dans la console après votre inscription. Chaque génération coûte 0,6 ¥ et renvoie 2 pistes, les téléchargements sont illimités et aucun numéro de téléphone n'est requis.
Obtenir une clé d'API Retour à la présentation