API de suppression des stems

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

Description du point d'accès

La suppression des stems masque de la liste les pistes de stem déjà générées. La suppression est logique : le backend ne fait que marquer les lignes de stem avec stem_hidden ; l'audio, le MIDI et les ressources de téléchargement sous-jacentes sont conservés, et le même morceau peut être séparé de nouveau en nouveaux stems plus tard.

Point d'accès : POST /api/music/stem-delete

Facturation : Gratuit. La suppression ne fait que mettre à jour la visibilité au sein de la plateforme ; elle n'appelle pas Suno et n'entraîne aucun frais.

Modèle recommandé : suno-v6. suno-v6, suno-v6-wild et suno-v6-mini sont disponibles.

Authentification

Paramètres de la requête

Au moins l'un de song_id / song_ids / stem_batch_id / stem_mode doit être fourni, sinon la réponse est 400.

Exemple de requête

curl -X POST https://www.suno-api.io/api/music/stem-delete \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["stem_track_id_1", "stem_track_id_2"]
  }'

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "hidden": 2,
    "affected_sources": 1
  }
}

Remarques

• Idempotent : si la piste est déjà masquée ou si l'ID n'existe pas, la réponse est hidden: 0 sans erreur ; répéter l'appel est donc sans risque.
• La suppression ne concerne que les morceaux de la clé d'API actuelle ; les pistes qui ne vous appartiennent pas ne sont pas modifiées.
• Lorsque le dernier stem visible de la liste est masqué, le marqueur « séparé » du morceau source est effacé en même temps.