APIMart
APIMart

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.

Tutorial

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, duration aceita 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:

EtapaO que eu faço
AcessoAdicionar chave de API, cabeçalho de autenticação e corpo JSON
GeraçãoEnviar prompt com o modo e modelo certos
VozUsar prompts de voz padrão, vozes clonadas ou fluxos de voz editados
EdiçãoEstender clipes, separar stems, mixar e exportar
RevisãoVerificar letras, uso de semelhança e termos comerciais
ArmazenamentoSalvar 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.

APIMart
Pipeline de música da API [Suno](https://suno.com/home) v5.5: do prompt à faixa publicada

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" com version em v6, v6-wild ou v6-mini.
  • O fluxo é assíncrono: POST /v1/music/generations retorna um ID de tarefa, depois você consulta GET /v1/music/tasks/{task_id} até status ficar completed e 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], e instrumental: true remove 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çãoDetalhes
Tipo de modeloGeração de músicas com IA via API assíncrona (ID da tarefa, depois consulta de status)
EntradasPrompt de texto; letras personalizadas com tags [Verse]/[Chorus]/[Bridge]/[Outro]; tags de estilo; instrumental: true
SaídaUma audio_url por faixa em data.result.music[] quando status é completed; audio_format pode ser mp3, m4a ou wav
Duração do clipeduration de 10–360 segundos no modo personalizado; a duração real depende do resultado
Recursos principaisModos inspiração, personalizado e instrumental; vocal_gender; Personas e modelos personalizados
DisponibilidadeSuno API da APIMart: model: "suno" mais version (v6 / v6-wild / v6-mini) ou custom_model_id; autenticação por chave de API Bearer
Ideal paraJingles publicitários, músicas de marca, trilhas para criadores, podcasts, músicas de fundo
LimitesResultados 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

APIMart

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 erroSignificadoO que fazer
401Não autorizadoVerifique a chave.
402Pagamento necessárioRecarregue seu saldo na APIMart.
429Limite de taxaAguarde um pouco e tente de novo.
502Erro upstreamTente 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

APIMart

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.

ModoVelocidadeControleCaso de uso idealEntrada necessária
DescriçãoMais rápidoBaixo (orientado por IA)Faixas de fundo, batidas lo-fi, ambientaçãoPrompt descritivo curto
Letras PersonalizadasMais lentoAlto (definido pelo usuário)Jingles de anúncios, músicas de marca, narrativaLetras completas + tags de estilo + título
InstrumentalRápidoMédioPodcasts, transições de vídeo, camadas ambientesTags 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 vozConsistência de marcaEsforço de configuraçãoNecessidades de governança
Vozes padrãoBaseada em promptMínimoBaixo — direitos de IA padrão
Vozes clonadasAlta — semelhança específicaModerado — dados de treinamento necessáriosAlto — consentimento e documentos legais necessários
PersonalizadaMuito alta — modelos personalizadosAlto — edição iterativaModerado — 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çãoAçãoFerramentas
RascunhoGerar clipe inicial com ganchoAPI Suno V6, letras estruturadas
ExtensãoChegar à duração desejadaduration no modo personalizado, ou o endpoint de continuação POST /v1/music/generations/extend
RefinamentoSeparar vocais e instrumentaisAPI separadora de stems
Pós-produçãoMixagem, EQ, Auto-TuneDAW (FL Studio, Ableton)
ExportaçãoConverter para WAV, anexar BPM e gêneroMarcaçã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 trabalhoFerramenta / APIAção principal
BriefingLLMGerar letras e tags de estilo a partir de um tema
GeraçãoAPI de geração Suno (APIMart)Enviar requisição POST com prompt e modo
Rastreamento de statusLoop de polling do n8nVerificar status da tarefa a cada 5 a 10 segundos
Revisão humanaFormulário de revisãoAprovar ou rejeitar antes do armazenamento
ArmazenamentoGoogle Drive / S3Baixar e armazenar MP3/WAV com metadados
ProduçãoSuíte de ediçãoImportar á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.

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.

Tags#Suno v5.5#API Suno#geração de músicas com IA#API de música#direitos comerciais de música

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.

Pronto para testar?

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.

Modelos de chatModelos de imagemModelos de vídeo
Explorar marketplace