Suno API: situação oficial, chaves de API e um exemplo em Python

Em 17 de outubro de 2026, a Suno tem uma API oficial, mas ninguém consegue se cadastrar nela: platform.suno.com mostra apenas um login para contas de API que já existem, sem documentação pública, preços ou acesso por autoatendimento, e a Suno disse em julho que começa com um grupo selecionado de parceiros. Sem convite, duas outras opções funcionam hoje.

Existe uma API oficial da Suno?

A Suno anuncia uma API em platform.suno.com, e essa única página é toda a fachada pública dela.

O título promete “original songs, covers, and mashups from a single prompt” por trás de “a simple REST API”, e a única ação na página é entrar com a conta Google vinculada à sua conta Suno ou com um código enviado por e-mail. Os outros links são suno.com, Termos e Privacidade, e nada mais; /docs e /pricing no mesmo domínio devolvem a mesma caixa de login (verificado em 17 de outubro de 2026). A API existe, mas o que ela tem de documentação ou de preços só aparece depois do login.

O convite a parceiros é conhecido pela Music Business Worldwide, que noticiou em 2 de julho de 2026 que o diretor de produto da Suno, Jack Brody, anunciou os planos em um post no LinkedIn em 1º de julho e vinculou um formulário de inscrição. O formulário, como a reportagem o cita, diz: “We're beginning to explore a developer API, starting with a curated group of partners.” Em outras palavras, a Suno começa a explorar uma API para desenvolvedores com um grupo selecionado de parceiros. Nenhuma data de lançamento foi anunciada, e nada na página da plataforma, nas notas de versão ou na central de ajuda acrescenta uma.

Para empresas, o caminho é o time de vendas: os Termos da Suno dizem “if you are an enterprise user, you must contact sales to use our Service”. A mesma reportagem observa que a Suno “has not released self-serve developer access or published its own API documentation”, o que bate com o que a página ainda mostra em outubro.

Três formas de chamar a Suno pelo código hoje

Acesso oficial de parceiro. O formulário que Brody vinculou em julho é a única porta que a Suno mostrou, e a reportagem descreve acesso antecipado para um grupo selecionado de parceiros, e não cadastro aberto. Em 17 de outubro de 2026 a página da plataforma traz só a caixa de login, sem formulário, lista de espera ou link para pedir acesso, e não encontramos nenhum link público para o formulário nas páginas da própria Suno. A Music Business Worldwide não informou prazo para um lançamento mais amplo.

O wrapper não oficial no GitHub. gcui-art/suno-api é o contorno mais conhecido: 3.259 estrelas e cerca de 100 issues abertas em 17 de outubro de 2026, com o último commit em 6 de março de 2026. O README diz que a API oficial “is not yet available” e pede três coisas: o cookie da sua própria conta Suno, copiado à mão da aba de rede do navegador; uma chave paga do 2Captcha, porque a Suno continua servindo desafios hCaptcha; e um navegador real controlado pelo Playwright com os patches do rebrowser. A issue #262, aberta em 14 de dezembro de 2025, diz que o autor “lacks the time to maintain it”.

Os Termos de Serviço da Suno, revisados pela última vez em 10 de agosto de 2026 e em vigor desde 3 de setembro de 2026, proíbem “any data mining, robots, scraping, or similar data gathering or extraction methods” e também proíbem obter conteúdo “through any means not intentionally made available or provided for through the Service”. Leia as duas cláusulas nos Termos da Suno antes de construir um produto sobre um wrapper que dirige o suno.com com o seu cookie. O próprio README não traz aviso sobre isso; sua única linha jurídica é a licença LGPL-3.0.

Uma plataforma de API de terceiros. A OmniaKey é uma plataforma de API de terceiros, e não a Suno. Ela vende acesso via API ao Suno v4.5 e ao Suno v6 pela própria API assíncrona de mídia, com uma chave que a OmniaKey emite e cobra. A documentação lista exatamente dois IDs de modelo, suno-v4.5 e suno-v6, e cada requisição devolve uma música finalizada e mixada, enquanto uma conta Suno mostra duas alternativas. Essa é a opção que rodamos de ponta a ponta abaixo.

Gerar uma música em Python

Uma requisição cria a tarefa, uma segunda chamada verifica o status, e o MP3 final chega como um link assinado. Exporte a chave, salve o script como suno_song.py e rode; o script consulta o status a cada 5 segundos, porque progress.percent é aproximado e pode ficar em 0 enquanto a tarefa roda.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Create the job. Reuse the same Idempotency-Key only when retrying this exact request.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Poll on status, not on progress.percent, until the job finishes.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Download the MP3 now: the signed URL expires in about an hour.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Rodamos esse mesmo script em 17 de outubro de 2026 e ele imprimiu duas linhas:

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

Do início ao arquivo salvo foram 82 segundos. O arquivo é um MP3 estéreo de 48 kHz, com cerca de 161 kbps, 2:55 de duração e 3,5 MB, instrumental porque o script define instrumental como true.

Para comparar os dois modelos nos dois modos de entrada, também geramos quatro músicas pela API da OmniaKey em 17 de outubro de 2026, a partir das 13:03 UTC, consultando o status a cada 4 segundos.

As quatro terminaram na primeira tentativa, e cada requisição devolveu um MP3. Uma descrição gerou uma música completa de cerca de três minutos; o mesmo estilo com oito versos nossos voltou com 45 a 63 segundos, então conte com uma faixa curta quando você escreve a letra. As taxas de bits ficaram entre 151 e 195 kbps em estéreo de 48 kHz, e os links assinados de download expiraram cerca de uma hora depois da criação de cada tarefa.

Parâmetros e limites

• Um input.lyrics não vazio muda para o modo de letra própria, em que input.prompt, parameters.style ou parameters.tags descreve o estilo; uma tarefa sem prompt e sem letra é recusada.
• O suno-v6 é escolhido pelo ID do modelo e não precisa de mv, enquanto mv vale só para a v4.5.
• Só generate é atendido. Extensão, letra avulsa e síntese de voz falham com 503 no_available_channel, e a cobrança inicial volta.
• Uma requisição é uma música finalizada, então parameters.n precisa ser 1.
• Os links dos arquivos são assinados e curtos, cerca de uma hora, e os registros de tarefa ficam guardados por 24 horas após a criação.

Erros e reembolsos

Uma tarefa que falha, é cancelada ou nunca chega ao provedor é reembolsada automaticamente, e uma tarefa cancelada que ainda termina é cobrada pelo estado em que acaba. Repetir a mesma chave de idempotência com o mesmo corpo devolve a tarefa original com um 200 em vez de criar uma segunda tarefa, então um retry depois de um timeout cobra uma vez só. A recuperação fica curta: se a criação der timeout, reenvie o corpo e a chave idênticos; com o ID da tarefa em mãos, continue consultando.

Perguntas frequentes

Existe uma API Suno gratuita?

A Suno não publica nenhum nível gratuito de API em platform.suno.com. Os planos gratuitos ficam no app suno.com: o v6-mini está aberto para todo mundo, e a variante v4.5-all é gratuita desde 21 de outubro de 2025. O resultado gerado no nível gratuito serve apenas para uso pessoal, não comercial.

Posso usar comercialmente músicas geradas por uma API Suno?

Os Termos da Suno cedem o Output a assinantes Pro e Premier, e permitem uso comercial apenas do Output “downloaded by you through an approved channel”, ou seja, baixado por você por um canal aprovado. O Output do nível gratuito continua não comercial, e remixes são só para uso pessoal, qualquer que seja o plano. Músicas vindas de uma API de terceiros não são exceção, então leia os Termos da Suno antes de colocar uma música gerada em um produto pago.

Quanto tempo leva uma música?

A documentação de áudio estima de vinte segundos a dois minutos por geração. Nossas quatro tarefas levaram de 70 a 105 segundos, e a execução do script levou 82 segundos do início ao arquivo salvo.

Uso a v4.5 ou a v6?

A Suno anunciou a família v6 em 9 de setembro de 2026 e a v4.5 em 1º de maio de 2025. A v6 é escolhida só pelo ID do modelo, enquanto a v4.5 usa parameters.mv para fixar uma versão, e o ID suno-v4.5 da OmniaKey não diz a qual variante da v4.5 ele corresponde. A Suno chama a v6 de modelo principal, então comece pelo Suno v6, a menos que você precise fixar uma versão antiga da v4.5.

Como consigo uma chave de API da Suno?

Se você já tem uma conta de API, entre em platform.suno.com com a conta Google vinculada à sua conta Suno ou com um código enviado por e-mail. Sem conta, o formulário de parceria de julho era a única porta pública, e ele não está na página hoje. Uma plataforma de terceiros como a OmniaKey emite a própria chave, separada de qualquer login da Suno.