Guia do modelo

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.

O Suno V6 na Revana em resumo
ItemDetalhe
Id do modelosuno-v6
Produzuma música com vocais, ou um instrumental
Faixas por jobduas versões da mesma requisição
Entradasprompt, style, lyrics, instrumental
Tamanho do promptaté 3,000 caracteres
Preço$0.08 por job, pelas duas faixas
Rotasuma 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.

Custo do Suno V6 por tamanho de lote
JobsFaixas que você recebeTotal
12$0.08
1020$0.80
100200$8.00
1,0002,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

  • prompt descreve em palavras simples a música que você quer: o clima, sobre o que ela é, para quem é.
  • style indica o gênero e o som, como "lo-fi hip hop, soft piano, vinyl crackle" ou "upbeat pop punk, female vocals".
  • lyrics sã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.
  • instrumental definido como true cria 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.

cURL
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"
Python
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.js
// 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);
Resposta
{
  "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:

Baixar as duas faixas
# 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:

Corpo da requisição
{
  "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:

Corpo da requisição
{
  "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.