API do Suno: gere músicas com o Suno V6
O Suno V6 escreve e canta uma música completa a partir de uma ideia, de um estilo ou das suas próprias letras, ou toca um instrumental. Este guia mostra como chamá-lo por uma API REST, quanto custa e como as suas quatro entradas se combinam.
O que você obtém com a API do Suno V6
O Suno V6 é o modelo de música mais novo do Suno. Dê a ele uma ideia, um estilo, suas próprias letras ou uma mistura disso, e ele escreve e canta uma música completa, ou toca um instrumental. Na Revana, ele é o id de modelo suno-v6, chamado pelo mesmo endpoint de todos os modelos de vídeo e imagem.
| Item | Detalhe |
|---|---|
| Id do modelo | suno-v6 |
| Produz | uma música com vocais, ou um instrumental |
| Faixas por job | duas versões da mesma requisição |
| Entradas | prompt, style, lyrics, instrumental |
| Tamanho do prompt | até 3,000 caracteres |
| Preço | $0.08 por job, pelas duas faixas |
| Rotas | uma rota |
Preços da API do Suno (outubro de 2026)
O Suno V6 é cobrado por job, não por segundo nem por faixa. Um job custa $0.08 e retorna duas faixas, então cada música pronta custa metade disso.
| Jobs | Faixas que você recebe | Total |
|---|---|---|
| 1 | 2 | $0.08 |
| 10 | 20 | $0.80 |
| 100 | 200 | $8.00 |
| 1,000 | 2,000 | $80.00 |
Um job que falha não é cobrado. O crédito é pré-pago, a partir de $10, sem assinatura; veja a página de preços.
As quatro entradas e como elas se combinam
promptdescreve em palavras simples a música que você quer: o clima, sobre o que ela é, para quem é.styleindica o gênero e o som, como "lo-fi hip hop, soft piano, vinyl crackle" ou "upbeat pop punk, female vocals".lyricssão as suas próprias palavras a serem cantadas. Marcações de seção como[Verse]e[Chorus]em linhas separadas ajudam o modelo a dar forma à música.instrumentaldefinido comotruecria música sem vocais.
Cada requisição precisa de style ou lyrics (ou ambos). instrumental: true não pode ser enviado junto com lyrics, já que não haveria quem cantasse; uma requisição que quebre qualquer uma das regras é recusada antes de qualquer cobrança.
Gerar uma música
Envie POST /v1/generations com o id do modelo e um input, depois consulte até o job ter succeeded ou failed. Esta requisição custa $0.08.
export REVANA_API_KEY="sr_live_..."
# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"input": {
"prompt": "A warm, hopeful song about a small bakery opening before sunrise on a quiet street.",
"style": "acoustic indie folk, male vocals, fingerpicked guitar, light percussion"
},
"max_cost_usd": 0.1
}'
# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
-H "Authorization: Bearer $REVANA_API_KEY"import os
import time
import requests
API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}
resp = requests.post(f"{API}/generations", headers=HEADERS, json={
"model": "suno-v6",
"input": {
"prompt": "A warm, hopeful song about a small bakery opening before sunrise on a quiet street.",
"style": "acoustic indie folk, male vocals, fingerpicked guitar, light percussion",
},
"max_cost_usd": 0.1,
})
resp.raise_for_status()
job = resp.json()
while job["status"] in ("queued", "running"):
time.sleep(5)
job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
if job["status"] == "succeeded":
print(job["output"]["urls"], job["cost_usd"])
else:
print("Failed:", job["error"])// Node 18 or later. Save as generate.mjs and run: node generate.mjs
const API = "https://api.revana.si/v1";
const headers = {
Authorization: `Bearer ${process.env.REVANA_API_KEY}`,
"Content-Type": "application/json",
};
const res = await fetch(`${API}/generations`, {
method: "POST",
headers,
body: JSON.stringify({
model: "suno-v6",
input: {
prompt: "A warm, hopeful song about a small bakery opening before sunrise on a quiet street.",
style: "acoustic indie folk, male vocals, fingerpicked guitar, light percussion",
},
max_cost_usd: 0.1,
}),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
let job = await res.json();
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 5000));
job = await (await fetch(`${API}/generations/${job.id}`, { headers })).json();
}
if (job.status === "succeeded") console.log(job.output.urls, job.cost_usd);
else console.error("Failed:", job.error);{
"id": "gen_01JC2V8K5T",
"model": "suno-v6",
"status": "succeeded",
"output": {
"urls": [
"https://cdn.revana.si/g/gen_01JC2V8K5T/0.mp3",
"https://cdn.revana.si/g/gen_01JC2V8K5T/1.mp3"
]
},
"cost_usd": 0.08,
"attempts": 1,
"error": null,
"created_at": "2026-10-28T10:14:02Z",
"completed_at": "2026-10-28T10:15:31Z"
}Os dois arquivos em output.urls são duas versões da mesma requisição. Baixe-os pela API assim:
# Each Suno job returns two tracks. Fetch both once the job has succeeded.
curl -L -o take-1.mp3 https://api.revana.si/v1/generations/gen_01JC2V8K5T/content \
-H "Authorization: Bearer $REVANA_API_KEY"
curl -L -o take-2.mp3 https://api.revana.si/v1/generations/gen_01JC2V8K5T/content/2 \
-H "Authorization: Bearer $REVANA_API_KEY"Cantar as suas próprias letras
Para fazer o Suno cantar palavras que você escreveu, envie-as em lyrics com um style:
{
"model": "suno-v6",
"input": {
"style": "synth pop, bright female vocals, 112 bpm",
"lyrics": "[Verse]\\nCity lights are coming on\\nEvery window tells a story\\n\\n[Chorus]\\nWe run until the morning\\nWe run until the sun"
},
"max_cost_usd": 0.1
}Um instrumental para um vídeo
Para música de fundo sob um clipe, omita lyrics e defina instrumental:
{
"model": "suno-v6",
"input": {
"prompt": "Calm background music for a 30 second product video about a ceramic coffee mug.",
"style": "ambient electronic, soft pads, slow tempo",
"instrumental": true
},
"max_cost_usd": 0.1
}A mesma chave de API também gera o vídeo. Combine uma faixa do Suno com um clipe de qualquer modelo do guia de modelos de vídeo, ou deixe um agente fazer as duas coisas pelo servidor MCP da Revana.
O Suno V6 está listado com todos os outros modelos na página de modelos, e a referência completa de requisições está na documentação. Obtenha uma chave de API para criar sua primeira música.
Perguntas frequentes
Quanto custa a API do Suno?
Em outubro de 2026, o Suno V6 custa $0.08 por job na Revana. Cada job retorna duas faixas, e um job que falha não é cobrado.
A API do Suno retorna duas músicas?
Sim. Cada job do Suno V6 retorna duas versões da mesma requisição. Baixe-as em /v1/generations/{id}/content e /content/2.
Posso usar minhas próprias letras com a API do Suno?
Sim. Envie-as em lyrics, com um style para o som. Marcações de seção como [Verse] e [Chorus] em linhas separadas ajudam a dar forma à música.
O Suno pode fazer música instrumental?
Sim. Defina instrumental como true e descreva a música em prompt e style. Não envie lyrics junto com uma requisição instrumental.
Qual o tamanho máximo de um prompt do Suno?
Até 3,000 caracteres. Um prompt maior é recusado antes de qualquer cobrança.
Crie uma música com uma só chave
Uma chave de API para o Suno V6 e todos os modelos de vídeo e imagem. Crédito pré-pago a partir de $10, cobrado apenas pelos jobs bem-sucedidos.