Suno API
Acesso à API do Suno para geração de música com IA — crie músicas com vocais, instrumentos e letras a partir de um prompt de texto.
curl -X POST https://runapi.ai/api/v1/suno/stitch_audio \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"prompt": "Crie um beat lo-fi relaxante com piano suave, crepitar de vinil e uma linha de baixo delicada, 2 minutos."
}'import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.stitchAudio.run({
model: "suno-v5.5",
prompt: "Crie um beat lo-fi relaxante com piano suave, crepitar de vinil e uma linha de baixo delicada, 2 minutos.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->stitchAudio->run([
'model' => 'suno-v5.5',
'prompt' => 'Crie um beat lo-fi relaxante com piano suave, crepitar de vinil e uma linha de baixo delicada, 2 minutos.',
]);require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.stitch_audio.run(
model: "suno-v5.5",
prompt: "Crie um beat lo-fi relaxante com piano suave, crepitar de vinil e uma linha de baixo delicada, 2 minutos."
)npx skills add runapi-ai/suno -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorSuno gera músicas completas a partir de prompts de texto, incluindo vocais, instrumentação e letras. Abrange do V4 ao V5.5, com cada geração produzindo faixas prontas para transmissão em qualquer gênero musical.
- Variantes para diferentes metas de qualidade e latência
- API key unificada
- O model skill inclui documentação, schemas e notas de setup
- Gerações com falha não são cobradas
Variantes
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Instale o skill Suno para desenvolver apps
Carregue documentação do modelo, schemas, notas de preço e etapas de setup no seu workspace de código.
# Install the model skill for app development workflows
npx skills add runapi-ai/suno -gInstall the Suno skill for this app: 1. Add runapi-ai/suno with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
Como construir com este model skill
Escolha o modelo
Selecione o modelo e a variante que combinam com seu tipo de saída, meta de qualidade e latência.
Autentique uma vez
Use sua chave RunAPI para todos os modelos compatíveis.
Instale o skill
Adicione o model skill ao workspace de código antes de implementar a funcionalidade.
Receba a saída
Consulte por task ID ou trate o callback quando a geração terminar.
Onde Suno se encaixa
Suno é uma plataforma de geração de música com IA que cria músicas originais — vocais, instrumentos e letras — a partir de descrições em texto. Pelo RunAPI, todas as versões do Suno compartilham uma única API key com cobrança por chamada.
Por que usar Suno pela RunAPI
Uma API key
Use as mesmas credenciais entre modelos e provedores.
Pronto para skills
O model skill inclui schemas, notas de setup, contexto de preços e IDs de modelo.
Cobrança previsível
O preço por uso fica visível antes da chamada.
Perguntas frequentes
Qual é a duração máxima de uma música gerada?
Até 8 minutos por geração no v4.5 e v5+ (versões anteriores até 4 minutos). Use o endpoint Extend para encadear segmentos em faixas mais longas.
Posso fornecer minhas próprias letras?
Sim — passe letras com tags [Verse], [Chorus] e [Bridge]. Você também pode deixar o Suno escrever letras a partir de um prompt de tema.
Qual é o tempo de geração?
Tipicamente 30–120 segundos por faixa. Faixas apenas instrumentais tendem a gerar mais rápido.
Posso criar faixas apenas instrumentais?
Sim — defina o flag instrumental como true e o Suno gera uma faixa sem vocals.
Quais gêneros são suportados?
Qualquer gênero — pop, jazz, lo-fi, clássico, metal, hip-hop, eletrônico e mais. Descreva o gênero no seu prompt.
Como chamo este modelo?
Instale o model skill e siga as notas de setup com sua chave RunAPI.
Gerações com falha custam dinheiro?
Gerações com falha não são cobradas
Posso chamar a partir da minha aplicação?
Sim. Instale o model skill no workspace de código e use durante a implementação da funcionalidade.