API de génération d'effets sonores
Description du point d'accès
La génération d'effets sonores crée quelques secondes d'audio, pas un morceau. Elle convient aux sons courts comme le tonnerre, les gouttes de pluie ou un impact, ainsi qu'aux effets de transition, aux ambiances et aux boucles de batterie ; la plupart durent moins de 5 secondes et le plus long avoisine 20 secondes. Les modes ponctuel et boucle sont tous deux pris en charge.
Point d'accès : POST /api/music/sounds
Facturation : Payant, actuellement 0,6 CNY par appel par défaut. Le montant réellement débité suit la configuration tarifaire actuelle du back-office.
Temps d'attente et timeouts (important) : c'est un point d'accès synchrone — la commande n'est acceptée et transmise à la génération qu'à l'arrivée de la réponse. D'après les mesures, la plupart des requêtes répondent en 1 à 3 secondes, environ 10 % prennent plus de 30 secondes et la plus longue avoisine 230 secondes. Réglez le timeout du client à 300 secondes ou plus ; l'absence de réponse ne signifie pas qu'aucune génération n'a eu lieu, et ne réessayez pas juste après un timeout (cela duplique la commande et refacture). Si la connexion a été coupée, vérifiez plus tard avec
GET /api/music/songs. Voir « Temps d'attente et réglage du timeout » dans la Présentation de la nouvelle API.
Paramètres de la requête
Headers
| Paramètre | Type | Obligatoire | Remarques |
|---|---|---|---|
| Authorization | string | oui | Bearer YOUR_API_KEY |
| Content-Type | string | oui | application/json |
Paramètres du corps
| Paramètre | Type | Obligatoire | Par défaut | Remarques |
|---|---|---|---|---|
| model | string | non | suno-v6 | Nom de modèle côté client : suno-v6, suno-v6-wild ou suno-v6-mini |
| description | string | oui | - | Décrivez le son souhaité ; les phrases courtes en anglais sont les plus fiables, par exemple cinematic whoosh transition, bright impact |
| title | string | non | - | Titre ; s'il est omis, il peut être généré à partir de la description |
| type | string | non | one_shot | Type : one_shot (ponctuel) ou loop (boucle) |
| loop | boolean | non | false | Lecture en boucle ; équivaut à mettre type sur loop |
| bpm | number | non | - | BPM ; doit être un nombre supérieur à 0. Une valeur invalide renvoie 400 (invalid_sound_bpm) au lieu d'être ignorée silencieusement |
| key | string | non | - | Tonalité, au format nom de note (C-B) + #/b facultatif + Major/Minor facultatif, par exemple C Major, C#m, Bb ; vide ou any signifie sans restriction. Une valeur invalide renvoie 400 (invalid_sound_key) |
Exemple de requête
curl -X POST https://www.suno-api.io/api/music/sounds \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"description": "cinematic whoosh transition, bright impact",
"title": "cinematic whoosh",
"type": "one_shot",
"loop": false,
"bpm": 120,
"key": "C"
}'
Réponse
Un tableau de morceaux est renvoyé ; les champs sont identiques aux champs communs de réponse de morceau de la Présentation de la nouvelle API.
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