

Como usar o Suno v5.5: músicas e vozes com IA
Um guia passo a passo de Suno v5.5— configure o acesso, gere músicas por modo, gerencie vozes, estenda clipes, armazene arquivos e verifique direitos comerciais.
A Suno substituiu o v5.5 pelos modelos V6 em 9 de setembro de 2026, mas o fluxo deste guia continua valendo: envie um prompt de texto, consulte a tarefa e leve o arquivo para revisão, armazenamento e lançamento. Pela Suno API da APIMart, agora você chama v6, v6-wild ou v6-mini em vez do v5.5 (Suno: Introducing v6).
Se eu tivesse que resumir este guia, ele se reduz a isto:
-
Configuro o acesso à API com uma chave, cabeçalhos e polling
-
Escolho o modo certo: descrição, letras personalizadas ou somente música
-
Molde a saída com prompts curtos, indicações de voz e extensão de clipe
-
Movo os rascunhos por stems, mixagem, exportação e aprovação
-
Salvo os arquivos logo porque a APIMart guarda os resultados por apenas 72 horas
-
Verifico direitos comerciais, registros de consentimento e logs de aprovação antes do lançamento
Este guia é voltado principalmente para pessoas que querem tornar a geração de músicas parte de um pipeline de conteúdo funcional, e não apenas testá-la manualmente. Isso inclui equipes de apps, equipes de anúncios, produtores de podcasts, estúdios de jogos e editores de cinema.
Alguns números importam desde já:
-
No modo personalizado,
durationaceita 10–360 segundos, e a duração final depende do resultado -
A primeira consulta deve esperar cerca de 3 segundos
-
O polling geralmente continua a cada 5 a 10 segundos
-
Erros de limite de taxa como 429 exigem um curto atraso de repetição
-
As datas para logs de aprovação devem ser armazenadas no formato dos EUA, como 07/16/2026
O que eu gosto nessa configuração é que o caminho é simples: enviar requisição → obter ID da tarefa → consultar status → baixar áudio → armazená-lo → revisar direitos.
Aqui está a versão curta do fluxo de trabalho:
| Etapa | O que eu faço |
|---|---|
| Acesso | Adicionar chave de API, cabeçalho de autenticação e corpo JSON |
| Geração | Enviar prompt com o modo e modelo certos |
| Voz | Usar prompts de voz padrão, vozes clonadas ou fluxos de voz editados |
| Edição | Estender clipes, separar stems, mixar e exportar |
| Revisão | Verificar letras, uso de semelhança e termos comerciais |
| Armazenamento | Salvar arquivos MP3/WAV aprovados no S3, Drive ou outro local permanente |
Em outras palavras: isto tem menos a ver com "fazer uma música" e mais com construir um sistema de produção musical repetível com entradas claras, etapas de revisão e tratamento de arquivos.

Principais pontos
- A Suno substituiu o v5.5 por V6, V6 Wild e V6 Mini em 9 de setembro de 2026; na APIMart você envia
model: "suno"comversionemv6,v6-wildouv6-mini. - O fluxo é assíncrono:
POST /v1/music/generationsretorna um ID de tarefa, depois você consultaGET /v1/music/tasks/{task_id}atéstatusficarcompletede lêdata.result.music[].audio_url. - O modo inspiração (
custom: false) cria a música a partir de uma descrição, o modo personalizado (custom: true) usa sua própria letra com tags como [Verse] e [Chorus], einstrumental: trueremove os vocais. - Espere cerca de 3 segundos antes da primeira consulta e depois consulte a cada 5–10 segundos; diante de um erro 429, aguarde um pouco antes de tentar de novo.
- O número de faixas retornadas não é fixo e os resultados ficam guardados por 72 horas, então baixe logo os arquivos aprovados, confirme os direitos de uso comercial e guarde os registros de consentimento de vozes clonadas.
Suno V6 em resumo
| Especificação | Detalhes |
|---|---|
| Tipo de modelo | Geração de músicas com IA via API assíncrona (ID da tarefa, depois consulta de status) |
| Entradas | Prompt de texto; letras personalizadas com tags [Verse]/[Chorus]/[Bridge]/[Outro]; tags de estilo; instrumental: true |
| Saída | Uma audio_url por faixa em data.result.music[] quando status é completed; audio_format pode ser mp3, m4a ou wav |
| Duração do clipe | duration de 10–360 segundos no modo personalizado; a duração real depende do resultado |
| Recursos principais | Modos inspiração, personalizado e instrumental; vocal_gender; Personas e modelos personalizados |
| Disponibilidade | Suno API da APIMart: model: "suno" mais version (v6 / v6-wild / v6-mini) ou custom_model_id; autenticação por chave de API Bearer |
| Ideal para | Jingles publicitários, músicas de marca, trilhas para criadores, podcasts, músicas de fundo |
| Limites | Resultados guardados por 72 horas; o número de faixas por tarefa não é fixo; pedidos com nomes de artistas ou semelhanças não autorizadas podem ser recusados |
Configure o acesso a Suno V6 para um projeto funcional

Sua primeira requisição se resume a três coisas: credenciais, cabeçalhos e polling assíncrono.
Chaves de API, autenticação e estrutura básica da requisição
Crie uma conta na APIMart e gere uma chave de API no console. Use chaves separadas para testes e produção, assim você pode trocar uma sem quebrar a outra.
Nunca deixe sua chave fixa no código-fonte. Coloque-a em uma variável de ambiente:
SUNO_API_KEY=your_key_here
Para trabalho local, use um arquivo .env. Em produção, use um gerenciador de segredos como o GitHub Secrets ou o AWS Secrets Manager. Em cada requisição, envie estes cabeçalhos:
-
Authorization: Bearer YOUR_API_KEY -
Content-Type: application/json
O fluxo é simples. Envie POST https://api.apimart.ai/v1/music/generations, guarde o task_id retornado, espere cerca de 3 segundos e consulte GET /v1/music/tasks/{task_id} a cada 5–10 segundos até status ficar completed ou failed. Ao concluir, leia cada audio_url em data.result.music[] sem supor um número fixo de faixas. Em caso de failed, o motivo vem em data.error.message e a cobrança é reembolsada automaticamente (docs da APIMart: gerar música, convenções de tarefas).
Assim que a faixa ficar pronta, baixe-a ou mova-a para um armazenamento permanente, como um bucket S3. A APIMart guarda os resultados por 72 horas, então a URL do resultado não serve como endereço definitivo do arquivo.
| Código de erro | Significado | O que fazer |
|---|---|---|
| 401 | Não autorizado | Verifique a chave. |
| 402 | Pagamento necessário | Recarregue seu saldo na APIMart. |
| 429 | Limite de taxa | Aguarde um pouco e tente de novo. |
| 502 | Erro upstream | Tente mais tarde, mas não reenvie às cegas uma requisição paga após um timeout. |
No payload JSON, defina model como "suno" e escolha version explicitamente: v6 (o carro-chefe), v6-wild (resultados mais variados) ou v6-mini (mais rápido). O v5.5 não está mais disponível, porque a Suno aposentou os modelos anteriores ao lançar o V6. Se usar um modelo personalizado, envie custom_model_id no lugar de version; os dois não podem ser combinados.
Usando o APIMart como camada de fluxo de trabalho

O APIMart envia requisições Suno por um único fluxo de trabalho no lado do servidor, o que mantém as credenciais fora do código do cliente. Em termos simples, os tokens brutos ficam fora do cliente, e cada chamada passa pela mesma camada de integração.
Em cada requisição, defina model e version explicitamente para que a tarefa rode na variante do V6 que você testou. Com o acesso pronto, o próximo passo é o design do prompt e as configurações de saída.
Gere músicas com o prompt, o modo e as configurações de saída certos
Com o acesso configurado, escolha o modo de geração e o formato de saída antes de escrever o prompt. Na APIMart, custom e instrumental são os dois campos a decidir logo de início, e audio_format define mp3, m4a ou wav. Depois disso, você pode ajustar vozes e etapas de revisão para transformar rascunhos em ativos realmente utilizáveis, como trilhas para projetos de vídeo.
Modo Descrição vs. Modo Letras Personalizadas
O Modo Descrição (custom: false) deixa a IA escrever as letras e escolher o estilo musical a partir de um prompt de texto curto. É melhor quando você quer saída rápida com pouca direção. O Modo Letras Personalizadas (custom: true) coloca você no comando. Você fornece as letras exatas, tags de seção como [Verse], [Chorus], [Bridge] e [Outro], além de detalhes de estilo como gênero, clima e andamento. Isso o torna mais adequado para anúncios, músicas de marca e faixas de criadores com uma estrutura definida.
| Modo | Velocidade | Controle | Caso de uso ideal | Entrada necessária |
|---|---|---|---|---|
| Descrição | Mais rápido | Baixo (orientado por IA) | Faixas de fundo, batidas lo-fi, ambientação | Prompt descritivo curto |
| Letras Personalizadas | Mais lento | Alto (definido pelo usuário) | Jingles de anúncios, músicas de marca, narrativa | Letras completas + tags de estilo + título |
| Instrumental | Rápido | Médio | Podcasts, transições de vídeo, camadas ambientes | Tags de estilo + instrumental: true |
Se você quiser saída somente instrumental, defina instrumental: true. Em seguida, use negative_tags para bloquear vocais que você não quer, como "vocals, singing, voice".
Padrões de prompt para anúncios, música de marca e conteúdo de criadores
Um padrão de prompt simples funciona bem aqui: [genre] [mood] [instruments] [voice] [era/influence]. Na prática, um prompt curto com poucos termos claros mantém o modelo no rumo melhor do que uma lista longa. Sinais misturados demais podem confundi-lo.
O modo deve combinar com o trabalho. Use o modo descrição quando estiver buscando atmosfera. Use o modo letras personalizadas quando a música precisar carregar uma mensagem, uma frase de marca ou uma história. Você também pode indicar a textura vocal diretamente com frases como "soft female vocals", "deep male baritone" ou "ethereal" para manter o som alinhado a um tom de marca ou estilo de canal.
Planejamento de saída para uso em produção
Para controlar a duração, defina duration (10–360 segundos) no modo personalizado e confira a duration real no resultado, porque o alvo não é garantido. Para alongar uma faixa existente, use o endpoint de continuação POST /v1/music/generations/extend (docs da APIMart: continuação e extensão). Incluir um [Outro] dedicado ou um marcador claro de final ajuda a faixa a terminar de forma limpa.
Para trabalho de produção, gere mais de uma versão, baixe cada uma imediatamente e salve um corte instrumental ao lado de qualquer faixa vocal. Isso lhe dá uma alternativa caso uma versão vocal não se encaixe no anúncio, na edição ou na revisão final. Também ajuda armazenar cada ativo com seu prompt e metadados em uma pasta de projeto consistente.
Em seguida, refine as vozes e as etapas de edição para que a melhor versão esteja pronta para revisão.
Gerencie vozes, etapas de edição e controles de fluxo comercial
Vozes padrão, vozes clonadas e fluxos de voz personalizada
O Suno V6 oferece três fluxos vocais, e escolher o certo no início pode economizar muito trabalho de limpeza depois.
As vozes padrão são o caminho mais rápido. Você descreve o estilo vocal no seu prompt — algo como soft female vocals, ethereal ou deep male baritone — e o modelo cuida do resto. Essa opção funciona bem para rascunhos comerciais rápidos quando você não precisa de uma identidade de voz fixa.
As vozes clonadas exigem mais configuração, mas dão a você um som estável e reconhecível. Use vozes clonadas apenas quando tiver consentimento claro e documentado do dono da voz.
Os fluxos de voz personalizada vão além. Na Suno, as Personas são um recurso do Premier, enquanto os modelos personalizados estão no Pro e no Premier (preços da Suno). Pela APIMart você envia persona_id (somente no modo personalizado) ou custom_model_id, que não podem ser usados na mesma requisição (docs da APIMart).
| Tipo de voz | Consistência de marca | Esforço de configuração | Necessidades de governança |
|---|---|---|---|
| Vozes padrão | Baseada em prompt | Mínimo | Baixo — direitos de IA padrão |
| Vozes clonadas | Alta — semelhança específica | Moderado — dados de treinamento necessários | Alto — consentimento e documentos legais necessários |
| Personalizada | Muito alta — modelos personalizados | Alto — edição iterativa | Moderado — aprovação interna necessária |
Depois de escolher o caminho da voz, a próxima etapa é simples: mover o rascunho pela edição e pela aprovação.
Do rascunho de música ao ativo utilizável
A primeira geração é um rascunho. Não é o ativo finalizado.
O fluxo de trabalho é assim: Rascunho → estender → separar stems → mixar → exportar.
Comece verificando as letras e o tom vocal em relação ao seu briefing. Depois separe os stems para que vocais e instrumentais fiquem em camadas separadas. Isso dá à sua equipe de áudio espaço para trabalhar dentro de uma DAW como o FL Studio ou o Ableton, onde podem aplicar EQ, compressão e reverb. Depois disso, exporte a versão final como WAV e anexe metadados como BPM, gênero e tags de estilo antes de salvá-la na pasta do projeto.
| Etapa de produção | Ação | Ferramentas |
|---|---|---|
| Rascunho | Gerar clipe inicial com gancho | API Suno V6, letras estruturadas |
| Extensão | Chegar à duração desejada | duration no modo personalizado, ou o endpoint de continuação POST /v1/music/generations/extend |
| Refinamento | Separar vocais e instrumentais | API separadora de stems |
| Pós-produção | Mixagem, EQ, Auto-Tune | DAW (FL Studio, Ableton) |
| Exportação | Converter para WAV, anexar BPM e gênero | Marcação de metadados, conversão WAV |
Baixe o áudio aprovado imediatamente.
Licenciamento, uso comercial e verificações de aprovação interna
Antes do lançamento, resolva os direitos e registre a aprovação de cada faixa finalizada.
Primeiro, confirme que a conta usada para gerar a música inclui direitos de uso comercial.
Em seguida, configure uma etapa leve de aprovação interna. Sinalize qualquer prompt ou conjunto de letras que mencione nomes específicos de artistas ou semelhanças não autorizadas. Requisições ligadas a semelhanças não autorizadas ou nomes de artistas podem ser rejeitadas. Se estiver trabalhando com ativos de voz clonada, mantenha os registros de consentimento junto ao arquivo de áudio.
Para rastreamento de auditoria, registre o ID da tarefa, o título da música, a duração, as tags de estilo e a data de aprovação de cada ativo finalizado. Use o formato de data dos EUA — como 07/16/2026 — e registre quem o aprovou.
Construa um pipeline de música APIMart de ponta a ponta
Um pipeline de produção simples para equipes
Uma vez fixadas suas escolhas de prompt, voz e licenciamento, una tudo em um único fluxo repetível: briefing entra, áudio aprovado sai e depois é armazenado para vídeo, anúncios ou redes sociais.
Envie o briefing para a Suno pela APIMart. A API retorna um ID de tarefa, e sua camada de orquestração — como o n8n — pode rodar um loop de consulta até status voltar como completed ou failed. Espere cerca de 3 segundos antes da primeira consulta para não enviar requisições à toa.
O objetivo é simples: mapear cada transferência para uma ferramenta ou API para que o processo rode sem que alguém precise perseguir arquivos ou atualizações de status manualmente.
| Estágio do fluxo de trabalho | Ferramenta / API | Ação principal |
|---|---|---|
| Briefing | LLM | Gerar letras e tags de estilo a partir de um tema |
| Geração | API de geração Suno (APIMart) | Enviar requisição POST com prompt e modo |
| Rastreamento de status | Loop de polling do n8n | Verificar status da tarefa a cada 5 a 10 segundos |
| Revisão humana | Formulário de revisão | Aprovar ou rejeitar antes do armazenamento |
| Armazenamento | Google Drive / S3 | Baixar e armazenar MP3/WAV com metadados |
| Produção | Suíte de edição | Importar áudio para modelos de vídeo ou anúncio |
Um detalhe importa aqui: a APIMart guarda os resultados de geração por 72 horas. Por isso seu pipeline deve baixar os arquivos aprovados na hora e movê-los para um armazenamento permanente antes que esse prazo acabe.
Quando o fluxo básico estiver funcionando, adicione um roteamento de falhas para que gerações rejeitadas voltem à etapa do prompt. Se uma tarefa terminar como failed, leia data.error.message, ajuste o prompt e reenvie. A APIMart reembolsa automaticamente as tarefas que falham, então a fila continua andando sem travar.
Primeiros passos
Comece com um fluxo de trabalho que você possa repetir e depois cresça a partir daí somente após ele funcionar de ponta a ponta. Escolha primeiro um caso de uso — um jingle de anúncio, uma faixa de fundo de marca ou uma trilha de criador.
Antes de qualquer coisa entrar no ar, verifique se o seu plano inclui claramente direitos de uso comercial. Depois use o APIMart como a camada que conecta a geração de música ao seu fluxo de conteúdo de IA mais amplo, para que uma requisição de música possa percorrer um sistema que sua equipe pode usar repetidamente.
Perguntas frequentes
Como escolho entre os modos descrição, letras personalizadas e instrumental?
Escolha com base em quanto controle você quer.
-
Use o modo Descrição se quiser que a IA crie as letras e a composição a partir de um prompt de texto.
-
Use o modo Personalizado se quiser fornecer suas próprias letras e estrutura de música.
-
Use o modo Instrumental se quiser uma faixa sem vocais, como música de fundo ou jingles.
O que devo armazenar com cada faixa gerada para aprovação comercial?
Mantenha um registro claro de cada faixa que você fizer. No mínimo, armazene:
-
o ID único da tarefa
-
o arquivo de áudio final gerado
-
metadados como título da música, duração e tags de estilo ou prompts
-
a versão do modelo e a data de criação
Esse registro torna muito mais fácil verificar a conformidade de licenciamento e manter uma trilha de auditoria para uso comercial.
Como posso evitar que links de áudio temporários expirem em produção?
Os resultados da Suno API na APIMart ficam guardados por apenas 72 horas, então os links de resultado não servem para ativos de produção de longo prazo.
Aqui está a jogada mais segura: assim que o polling de status mostrar que a tarefa foi concluída com sucesso, baixe o arquivo de áudio imediatamente e envie-o para armazenamento persistente.
Isso pode ser algo como:
-
Google Drive
-
Seu sistema de arquivos local
Se você esperar demais, o link pode expirar e o arquivo pode sumir quando seu app tentar buscá-lo.
Sobre a equipe APIMart
A equipe APIMart escreve guias de modelos, comparativos e análises de preço para desenvolvedores que constroem com IA. A APIMart oferece uma única API para modelos de chat, imagem e vídeo de vários provedores, para que você compare os modelos citados aqui antes de lançar.
Escolha o modelo que você quer no marketplace
Teste modelos de chat, imagem e vídeo no marketplace da APIMart e experimente rapidamente as capacidades dos modelos com uma API unificada.
