API de remasterisation (Remaster)

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

Description du point d'accès

La remasterisation régénère un morceau déjà terminé sous forme de « version remasterisée » de meilleure qualité audio. Elle renvoie 2 versions d'un coup et l'upstream ajoute automatiquement (Remastered) au titre.

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

Facturation : Payant, facturé selon le modèle demandé (par défaut suno-v6, 0,6 CNY par appel) ; le montant réellement débité suit la configuration tarifaire du back-office.

À propos du modèle : la remasterisation utilise un point d'accès upstream dédié et un modèle de remasterisation dédié, fixés par la plateforme et qui ne dépendent pas de model ; le model de la requête ne sert qu'au tarif et au choix du canal, et il est recommandé de transmettre explicitement suno-v6.

Temps d'attente et timeouts (important) : c'est un point d'accès synchrone — la commande n'est acceptée et transmise à la remasterisation qu'à l'arrivée de la réponse. Réglez le timeout du client à 300 secondes ou plus ; l'absence de réponse ne signifie pas qu'aucune remasterisation 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.

Authentification

Paramètres de la requête

audio_id, source_clip_id et sourceClipId sont des écritures équivalentes de song_id ; utilisez l'une d'elles.

Exemple de requête

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

Si les valeurs par défaut vous suffisent, envoyez uniquement le morceau source : cela équivaut à variation_category: normal + style_profile: boost :

{ "model": "suno-v6", "song_id": "source_song_id" }

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Titre du morceau source (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Titre du morceau source (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Un appel renvoie 2 versions remasterisées. Enregistrez les deux clips[].song_id, puis interrogez l'API de consultation des morceaux jusqu'à complete avant de récupérer l'audio.

Remarques

• Le morceau source doit être terminé et dans le périmètre d'accès de la clé d'API actuelle ; la matière source externe est synchronisée automatiquement vers le compte d'exécution.
• La remasterisation ne refait que la qualité audio : pour changer le style, l'arrangement ou le chant, utilisez renforcer le style, envoyer puis faire un cover ou les points d'accès Remix.
• Plus variation_category est élevé, plus la version remasterisée diffère du morceau source ; avant une livraison réelle, essayez d'abord normal puis augmentez.