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 Wild 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-wild/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-wild/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 Wild
Quanto custa a API do Suno v6 Wild?
O Suno v6 Wild 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 Wild na API?
Coloque suno/v6-wild/text-to-audio para Música no campo model de POST /jobs/createTask.
O Wild é melhor que o v6?
Não em nenhuma medida que possamos afirmar. Ele tem outro caráter: teste os dois com a mesma descrição e compare as duas versões que cada um devolve.
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 em tom agudo. 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.
Quais são os limites da API do Suno v6 Wild?
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 Wild sem escrever código?
Dá. O Playground roda o Suno v6 Wild 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

