API de suppression de la voix

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

Description du point d'accès

La suppression de la voix sépare un morceau existant en deux pistes : voix et accompagnement. C'est la forme raccourcie de la séparation : il suffit de fournir l'ID du morceau source, aucun mode de séparation n'est à choisir, et le serveur traite toujours en deux pistes (two).

Point d'accès : POST /api/music/vocal-removal

Facturation : Gratuit. Ce point d'accès ne fait que séparer des pistes ; il n'entraîne aucun coût de génération et n'écrit aucun débit.

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

Authentification

Paramètre	Type	Obligatoire	Remarques
Authorization	string	oui	`Bearer YOUR_API_KEY`
Content-Type	string	oui	`application/json`

Paramètres de la requête

Paramètre	Type	Obligatoire	Par défaut	Remarques
model	string	oui	-	Nom de modèle côté client : `suno-v6`, `suno-v6-wild` ou `suno-v6-mini`
source_clip_id	string	oui	-	Le vrai `song_id` du morceau source ; il doit être terminé et accessible à la clé d'API actuelle
source_audio_url	string	non	-	Adresse de l'audio source (lorsque la source appartient à un autre compte, le serveur fait le relais ; le client n'a pas à l'envoyer)
source_file_name	string	non	-	Nom du fichier source ; utilisé uniquement pour les journaux et l'affichage
song_title	string	non	-	Préfixe du titre du résultat ; par défaut, le titre du morceau source est conservé

Alias compatibles : sourceClipId, audio_id, audioId et song_id peuvent remplacer source_clip_id.

Exemple de requête

curl -X POST https://www.suno-api.io/api/music/vocal-removal \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "song_title": "Suppression de la voix"
  }'

Réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Suppression de la voix (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Suppression de la voix (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Un seul envoi renvoie 2 versions × {Vocals, Instrumental}, donc clips contient généralement 4 entrées. Regroupez par stem_from_id et distinguez voix et accompagnement par le suffixe de song_title.

Remarques

Interrogez les pistes obtenues avec l'API de consultation des morceaux (POST /api/music/query) jusqu'à completed avant de les utiliser ; GET /api/music/songs/:song_id et la liste d'historique n'incluent pas actuellement les pistes produites par la suppression de la voix — c'est une différence connue.
Pour choisir un mode deux pistes ou multipiste, ou découper par nom de piste, utilisez l'API de séparation (voix et accompagnement).
Les pistes inutiles peuvent être masquées avec l'API de suppression de piste ; n'envoyez pas de demandes de suppression répétées.

SuivantAPI de suppression des stems

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