API de obtenção de MIDI

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

Descrição do endpoint

O endpoint MIDI converte em arquivo MIDI padrão as faixas que já têm stems, para arranjo, trabalho criativo posterior ou importação num DAW.

O Suno não fornece um endereço de download de arquivos MIDI; fornece apenas os dados de notas de cada faixa (altura, tempos de início e fim, intensidade). Este endpoint converte esses dados de notas num arquivo MIDI padrão (SMF format 1) e devolve-o diretamente, portanto o que recebe é sempre um .mid real que um DAW consegue abrir.

Endpoint: POST /api/music/download-file

Esta página é o exemplo específico de MIDI. A descrição completa da família de downloads (endereços de mídia, arquivo único, empacotamento, pré-visualização durante a geração) está na API de download e pré-visualização de mídia de músicas.

Cobrança: Grátis. Este endpoint lê os dados de notas de stems existentes e não desconta cota.

Parâmetros da requisição

Headers

Parâmetros do corpo

Exemplo de requisição

curl -X POST https://www.suno-api.io/api/music/download-file \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "stem_clip_id",
    "kind": "midi"
  }' \
  --output track.mid

Resposta

O corpo da resposta é o conteúdo binário do arquivo MIDI, não JSON.

Obter um endereço de download

Se precisar primeiro do endereço e só depois descarregar (por exemplo para empacotar vários arquivos), chame primeiro:

curl -X POST https://www.suno-api.io/api/music/download-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id":"stem_clip_id","kind":"midi"}'

{
  "success": true,
  "message": "",
  "data": {
    "song_id": "stem_clip_id",
    "kind": "midi",
    "url": "https://www.suno-api.io/api/music/download?song_id=stem_clip_id&kind=midi"
  }
}

Esse endereço também exige o cabeçalho Authorization para ser acessível; sem chave de API devolve 401.

Sobre o arquivo MIDI

Observações

• Só é válido para faixas que já têm stems: song_id tem de ser um ID de faixa devolvido por /api/music/separate, não o ID da música original.
• Um stem sem notas é um resultado normal: algumas faixas (por exemplo FX) não têm notas transcrevíveis; nesse caso é devolvido um arquivo MIDI válido sem notas em vez de um erro.
• O MIDI contém apenas informação de notas: volume, pan e efeitos não fazem parte do MIDI; define o timbre no próprio DAW.
• Peça cada faixa separadamente: um pedido devolve o .mid de uma faixa; para várias, chame cada uma ou use o download empacotado em lote do Create UI.