Documentação da API do Suno — gere música a partir de um prompt (V5 / V5.5), com preços

Suno é um modelo de música com IA de primeira linha — gera músicas completas com vocais, letras e instrumentação a partir de um prompt de texto. A API da Suno (Suno V5 e V5.5 na Kunavo) faz isso programaticamente por meio de POST /v1/audio/music, retornando faixas de áudio hospedadas com um único token bearer. Esta é a documentação prática: formato da solicitação, preços e o padrão assíncrono para produção.

Chame a API da Suno

Gere uma chave em /app/keys e envie um POST com um prompt. Uma solicitação retorna cerca de duas variações de faixa; a geração leva de dezenas de segundos a alguns minutos:

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

Os parâmetros completos e o ciclo de vida assíncrono da tarefa estão na referência da API de música.

Preços

A Suno é cobrada por solicitação de geração (não por faixa), portanto as cerca de 2 variações retornadas custam uma única cobrança. As tarifas atuais estão na página de cada modelo. A própria Suno não publica um preço de API por solicitação — sua própria API é um programa exclusivo para parceiros, sem tarifas públicas — portanto a tabela mostra apenas o que a Kunavo cobra.

Pague conforme o uso a partir de uma recarga mínima de $10; o saldo nunca expira e gerações com falha nunca são cobradas. Estime uma carga de trabalho maior com a calculadora de custos.

Modo personalizado: suas próprias letras

Em vez de um prompt simples, forneça lyrics, um descritor de style e um title para ter controle total, ou defina instrumental: true para ignorar completamente os vocais:

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

Assíncrono em produção

A geração de música não é instantânea; em escala, envie uma tarefa e consulte o resultado periodicamente em vez de manter a conexão aberta — a documentação de música aborda o ciclo de vida da tarefa, a consulta periódica e a entrega por webhook. As URLs dos resultados são permanentes quando a tarefa é concluída.

Kunavo versus usar a Suno diretamente

O produto próprio da Suno é uma assinatura com uma franquia de créditos, não uma API com cobrança conforme o uso — esse é justamente o motivo pelo qual os desenvolvedores acabam procurando uma “API da Suno”:

Se você gera música dentro de um produto, a cobrança por uso e um endpoint real são o ponto principal. Se uma pessoa usa um navegador para criar faixas manualmente, a própria assinatura da Suno é a compra mais simples.

API da Suno versus API da Udio

Udio é a outra grande família de geração de música, e “API da Udio” é uma busca paralela comum. A diferença prática hoje: o acesso à API da Udio passa por caminhos experimentais de terceiros, sem um preço público estável, enquanto Suno V5 / V5.5 na Kunavo é um endpoint compatível com uma tarifa fixa publicada ($0.09 por solicitação de geração). Se você precisa de geração de música confiável em produção — a API Suno V5 aqui é o caminho confiável; avaliaremos a Udio quando houver um upstream estável.

Além da música

A mesma chave alcança texto (Claude, GPT), imagem (Nano Banana, GPT-Image-2) e vídeo (Veo 3, Seedance 2, Wan 2.7) — assim, você pode encadear um pipeline completo: escrever o roteiro com um LLM, gerar os visuais e adicionar uma trilha sonora da Suno. Consulte o guia de IA multimodal para fluxos de imagem → vídeo → música.

Perguntas frequentes