API de remoção de voz

Atualizado em 2026-09-18 · equipe Suno-API

Descrição do endpoint

A remoção de voz divide uma música existente em duas faixas: voz e acompanhamento. É a forma rápida da separação: basta enviar o ID da música de origem, não é preciso escolher modo de separação, e o servidor sempre processa como duas faixas (two).

Endpoint: POST /api/music/vocal-removal

Cobrança: Grátis. Este endpoint apenas divide faixas; não gera custo de geração nem registra cobrança.

Modelo recomendado: suno-v6. suno-v6, suno-v6-wild e suno-v6-mini estão disponíveis.

Autenticação

Parâmetros da requisição

Aliases compatíveis: sourceClipId, audio_id, audioId e song_id podem ser usados no lugar de source_clip_id.

Exemplo de requisição

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": "Remoção de voz"
  }'

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "vocals_clip_id",
        "song_title": "Remoção de voz (Vocals)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      },
      {
        "song_id": "instrumental_clip_id",
        "song_title": "Remoção de voz (Instrumental)",
        "status": "pending",
        "stem_from_id": "source_song_id",
        "stem_mode": "two"
      }
    ]
  }
}

Um único envio devolve 2 versões × {Vocals, Instrumental}, portanto clips costuma conter 4 entradas. Agrupe por stem_from_id e diferencie voz de acompanhamento pelo sufixo de song_title.

Observações

• Faça polling das faixas resultantes com a API de consulta de músicas (POST /api/music/query) até completed antes de usá-las; GET /api/music/songs/:song_id e a lista de histórico atualmente não incluem as faixas produzidas pela remoção de voz — é uma diferença conhecida.
• Se precisar escolher modo de duas ou várias faixas, ou dividir por nome de faixa, use a API de separação (voz e acompanhamento).
• Faixas indesejadas podem ser ocultadas com a API de remoção de faixa; não envie solicitações de remoção repetidas.