Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
audio_weight | Não | How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1 |
generate_lyrics | Não | Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. Padrão: true |
image_urls | Não | Imagens que definem o clima; a música segue a sensação delas. |
instrumental | Não | Só música, sem vocal. Padrão: false |
lyrics | Não | Escreva sua própria letra ou deixe o modelo escrever. |
negative_prompt | Não | Estilos ou sons que você não quer na faixa. |
persona_id | Não | ID of an existing Suno persona to reuse its style or voice. |
persona_model | Não | Whether persona_id is a style persona or a voice persona. style_persona · voice_persona |
prompt | Sim | Describe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it. |
reference_audio_urls | Não | Áudio para combinar: uma voz, uma música ou um ritmo. |
reference_video_urls | Não | Um vídeo ao qual a música deve se encaixar. |
style_weight | Não | How closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1 |
title | Não | Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song. |
variety | Não | How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4 |
vocal_gender | Não | Make a female or male lead vocal more likely. Applies with lyrics. female · male |
weirdness | Não | How experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1 |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por geração | ≈ USD |
|---|---|---|
| Padrão | 10,8 | US$ 0,11 |
Cada tarefa é arredondada para cima em créditos inteiros, então uma execução no nível mais baixo custa 11 créditos por geração (US$ 0,11).
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do Suno v6 em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model suno/v6/text-to-audio e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Suno v6
Quanto custa a API do Suno v6?
O Suno v6 custa 11 créditos (US$ 0,11) por geração. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do Suno v6 na API?
Coloque suno/v6/text-to-audio para Música no campo model de POST /jobs/createTask.
O que a Suno diz sobre o v6?
A Suno diz que o v6 é confiável, preciso e entrega de forma consistente música refinada em todos os gêneros e estilos. Foi lançado em 9 de setembro de 2026, junto com o v6 Wild e o v6 Mini.
Ele vai cantar exatamente a minha letra?
Nos nossos testes com as configurações padrão, sim. Uma letra de 11 linhas foi cantada palavra por palavra na ordem escrita; tags de seção como [Chorus] não foram cantadas e o refrão não se repetiu sozinho.
Sou cobrado se uma requisição for recusada ou falhar?
Não. O valor reservado para a requisição é liberado por inteiro.
Posso escolher quem canta?
Em parte. Descreva a voz na descrição de estilo, por exemplo uma voz feminina segura. Com letra própria ou instrumental ativado, você também pode definir vocal_gender como female ou male; é uma preferência, não uma garantia, e não medimos com que frequência ela se cumpre. Um dueto pedido em uma ideia de uma frase voltou como solo no nosso teste, então indique uma só voz se isso importar.
Quais são os limites da API do Suno v6?
Imagens de referência: 5; Áudio de referência: 1; Vídeos de referência: 1; Tamanho do prompt (caracteres): 3,000. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Suno v6 sem escrever código?
Dá. O Playground roda o Suno v6 com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.
Todos os modelos Suno
O Suno v6 é o mais confiável para músicas que você já tem na cabeça. O v6 Wild toma caminhos mais surpreendentes e texturizados, e o v6 Mini é o caderno de rascunhos rápido, todos pelo mesmo preço por rodada.
- API do Suno v6Músicas completas com vocal a partir da sua letra ou de uma breve ideiaA partir de 11 créditos por geração
- API do Suno v6 MiniDuas músicas rápidas com vocal a partir de uma fraseA partir de 11 créditos por geração
- API do Suno v6 WildMúsicas experimentais e cheias de textura, com vocalA partir de 11 créditos por geração
