API de geração/obtenção de WAV

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

Descrição do endpoint

O endpoint WAV gera ou obtém o endereço de áudio WAV sem perdas de uma música existente.

Endpoint: POST /api/music/wav

Cobrança: Grátis. Este endpoint gera ou obtém o endereço WAV de uma música existente e não desconta cota.

Tempos de espera e timeouts (importante): este é um endpoint síncrono — o pedido só é aceito quando a resposta chega. Pelo medido, a maioria das requisições responde em 1-3 segundos, cerca de 10% leva mais de 30 segundos e a mais longa fica em torno de 230 segundos. Defina o timeout do cliente em 300 segundos ou mais; não receber resposta não significa que nada foi gerado, e não repita logo após um timeout. Se a conexão caiu, confirme depois com GET /api/music/songs. Veja "Tempos de espera e configuração de timeout" na Visão geral da nova API.

Parâmetros da requisição

Headers

Parâmetros do corpo

maxAttempts e intervalSeconds são ambos números JSON; intervalSeconds é medido em segundos, não em milissegundos, e normalmente basta manter os padrões. Eles apenas controlam quantas vezes e com que intervalo este endpoint aguarda internamente que o WAV fique pronto; não alteram o estado da tarefa de geração em si.

Exemplo de requisição

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Resposta

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Observações

A geração e a consulta do WAV são escolhidas automaticamente pelo servidor a partir do registro da música; o cliente não precisa fornecer nenhuma informação de conta.

Músicas normais e faixas separadas usam o mesmo caminho controlado de entrega de mídia. O WAV é primeiro baixado e gravado em disco pelo CN2, e o data.wavUrl de uma resposta bem-sucedida devolve apenas um endereço de CDN controlado — nunca um endereço temporário de origem do Suno ou do S3.

Quando já existe um ativo WAV em estado ready ele é reutilizado, sem pedir novamente ao Suno nem mover arquivos de novo. Um WAV ainda não preparado não é exposto como endereço Suno/S3 via /api/music/query; ele só é preparado sob demanda depois de chamar este endpoint ou o endpoint unificado de download.

⚠️ Validade do endereço WAV: 7 dias — guarde a tempo. O data.wavUrl devolvido é servido pelo armazenamento de objetos da plataforma e expira após 7 dias por padrão (o arquivo é recolhido e o endereço antigo devolve 404). Guarde o WAV no seu próprio armazenamento dentro desse prazo; depois de expirar, chame este endpoint novamente para obter um novo endereço válido.

Se o recurso da música estiver temporariamente indisponível, o endpoint devolve 409. Tente novamente mais tarde; o servidor não devolve endereços temporários instáveis.