API de génération/récupération WAV

Mis à jour le 2026-09-18 · équipe Suno-API

Description du point d'accès

Le point d'accès WAV génère ou récupère l'adresse audio WAV sans perte d'un morceau existant.

Point d'accès : POST /api/music/wav

Facturation : Gratuit. Ce point d'accès génère ou récupère l'adresse WAV d'un morceau existant et ne déduit aucun quota.

Temps d'attente et timeouts (important) : c'est un point d'accès synchrone — la commande n'est acceptée 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. 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ètres du corps

maxAttempts et intervalSeconds sont tous deux des nombres JSON ; intervalSeconds se mesure en secondes, pas en millisecondes, et conserver les valeurs par défaut suffit en général. Ils ne contrôlent que le nombre de fois et l'intervalle auxquels ce point d'accès attend en interne que le WAV soit prêt ; ils ne changent pas l'état de la tâche de génération elle-même.

Exemple de requête

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Remarques

La génération et la consultation du WAV sont choisies automatiquement par le serveur à partir de l'enregistrement du morceau ; le client n'a aucune information de compte à fournir.

Les morceaux normaux et les pistes séparées utilisent le même chemin de livraison média contrôlé. Le WAV est d'abord téléchargé et écrit sur disque par CN2, et le data.wavUrl d'une réponse réussie ne renvoie qu'une adresse CDN contrôlée — jamais une adresse source temporaire Suno ou S3.

Lorsqu'un actif WAV en état ready existe déjà, il est réutilisé, sans redemander à Suno ni déplacer à nouveau des fichiers. Un WAV pas encore préparé n'est pas exposé comme adresse Suno/S3 via /api/music/query ; il n'est préparé à la demande qu'après l'appel de ce point d'accès ou du point d'accès de téléchargement unifié.

⚠️ Validité de l'adresse WAV : 7 jours — sauvegardez-la à temps. Le data.wavUrl renvoyé est servi par le stockage objet de la plateforme et expire par défaut au bout de 7 jours (le fichier est récupéré et l'ancienne adresse renvoie 404). Sauvegardez le WAV dans votre propre stockage dans ce délai ; après expiration, rappelez ce point d'accès pour obtenir une nouvelle adresse valide.

Si la ressource du morceau est temporairement indisponible, le point d'accès renvoie 409. Réessayez plus tard ; le serveur ne renvoie pas d'adresses temporaires instables.