API de geração de efeitos sonoros

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

Descrição do endpoint

A geração de efeitos sonoros cria alguns segundos de áudio, não uma música. Serve para sons curtos como trovão, gotas de chuva ou um impacto, e também para efeitos de transição, ambiência e loops de bateria; a maioria dura menos de 5 segundos e o mais longo fica em torno de 20 segundos. São aceitos os modos de disparo único e em loop.

Endpoint: POST /api/music/sounds

Cobrança: Pago, atualmente 0,6 CNY por chamada por padrão. O valor realmente debitado segue a configuração de preços atual do back-office.

Tempos de espera e timeouts (importante): este é um endpoint síncrono — o pedido só é aceito e entregue à geração 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 (isso duplica o pedido e cobra de novo). 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âmetro	Tipo	Obrigatório	Observações
Authorization	string	sim	Bearer YOUR_API_KEY
Content-Type	string	sim	application/json

Parâmetros do corpo

Parâmetro	Tipo	Obrigatório	Padrão	Observações
model	string	não	suno-v6	Nome de modelo para o cliente: `suno-v6`, `suno-v6-wild` ou `suno-v6-mini`
description	string	sim	-	Descreva o som que você quer; frases curtas em inglês funcionam de forma mais confiável, por exemplo `cinematic whoosh transition, bright impact`
title	string	não	-	Título; quando não enviado, pode ser gerado a partir da descrição
type	string	não	one_shot	Tipo: `one_shot` (disparo único) ou `loop` (repetição)
loop	boolean	não	false	Se repete em loop; equivale a definir `type` como `loop`
bpm	number	não	-	BPM; deve ser um número maior que 0. Um valor inválido devolve 400 (`invalid_sound_bpm`) em vez de ser ignorado silenciosamente
key	string	não	-	Tonalidade, no formato de nota (C-B) mais `#`/`b` opcional mais `Major`/`Minor` opcional, por exemplo `C Major`, `C#m`, `Bb`; vazio ou `any` significa sem restrição. Um valor inválido devolve 400 (`invalid_sound_key`)

Exemplo de requisição

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Resposta

Devolve um array de músicas; os campos são os mesmos campos comuns de resposta de música da Visão geral da nova API.

PróximoAPI de geração de letras

Obter uma chave de API

Crie uma chave de API no console após o cadastro. Cada geração custa ¥0,6 e devolve 2 faixas, os downloads são ilimitados e não é preciso número de telefone.

Obter chave de API Voltar à visão geral