MúsicaSobre o Suno v6 Mini
O modelo v6 mais leve da Suno por API, feito pela Suno para transformar uma ideia em música: uma frase ou a sua própria letra entram, duas músicas prontas com voz saem, ao mesmo preço fixo do v6 e do v6 Wild.
Chame com o nome de modelo suno/v6-mini/text-to-audio em POST /jobs/createTask, a partir de 11 créditos por geração (US$ 0,11). Contas novas ganham 30 créditos grátis para você testar primeiro no Playground.
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 Mini 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-mini/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-mini/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 Mini
Quanto custa a API do Suno v6 Mini?
O Suno v6 Mini 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 Mini na API?
Coloque suno/v6-mini/text-to-audio para Música no campo model de POST /jobs/createTask.
O que é o v6 Mini?
A Suno descreve o v6 Mini como uma versão mais rápida e eficiente do v6, que facilita transformar uma ideia em música, e diz que é a versão disponível para todos. Foi lançado em 9 de setembro de 2026, junto com o v6 e o v6 Wild.
O tratamento da letra é o mesmo do v6?
Nos nossos testes, sim: os três cantaram palavra por palavra, em ordem, a mesma letra limpa de 11 linhas, com as tags de seção em silêncio. Não classificamos o som deles.
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 masculina calorosa. 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 frase voltou como solo no nosso teste.
Quais são os limites da API do Suno v6 Mini?
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 Mini sem escrever código?
Dá. O Playground roda o Suno v6 Mini 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
- 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
