API de exclusão de stems

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

Descrição do endpoint

A exclusão de stems oculta da lista as faixas de stem já geradas. A exclusão é uma exclusão lógica: o backend apenas marca as linhas de stem com stem_hidden; o áudio, o MIDI e os recursos de download continuam guardados, e a mesma música pode ser separada novamente em novos stems depois.

Endpoint: POST /api/music/stem-delete

Cobrança: Grátis. A exclusão só atualiza a visibilidade dentro da plataforma; não chama a Suno nem gera qualquer 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

É preciso enviar ao menos um de song_id / song_ids / stem_batch_id / stem_mode; caso contrário a resposta é 400.

Exemplo de requisição

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"]
  }'

Resposta

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

Observações

• Idempotente: se a faixa já estiver oculta ou o ID não existir, a resposta é hidden: 0 sem erro, então repetir a chamada é seguro.
• A exclusão afeta apenas músicas da chave de API atual; faixas que não são suas não são alteradas.
• Quando o último stem visível da lista é ocultado, a marca de «separada» da música de origem também é limpa.