Suno API
AI music generation — create full songs with vocals, instruments, and lyrics from a text prompt.
curl -X POST https://runapi.ai/api/v1/suno/cover_audio \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"prompt": "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."
}'import { SunoClient } from "@runapi.ai/suno";
const client = new SunoClient();
const result = await client.coverAudio.run({
model: "suno-v5.5",
prompt: "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.",
});<?php
require __DIR__ . "/vendor/autoload.php";
use RunApi\Suno\SunoClient;
$client = new SunoClient();
$result = $client->coverAudio->run([
'model' => 'suno-v5.5',
'prompt' => 'Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.',
]);require "runapi/suno"
client = RunApi::Suno::Client.new
result = client.cover_audio.run(
model: "suno-v5.5",
prompt: "Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long."
)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 generates complete songs from text prompts, including vocals, instrumentation, and lyrics. It spans V4 through V5.5, with each generation producing broadcast-ready tracks across any musical genre.
- Wiele wariantów dla różnych poziomów szybkości i jakości
- Model skill zawiera dokumentację, schematy i notatki setupu
- Działa z workflow kodowania aplikacji
- Nie płacisz za nieudane generacje
Porównaj wszystkie warianty API
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Zainstaluj skill Suno do tworzenia aplikacji
Wczytaj dokumentację modelu, schematy, notatki cenowe i kroki setupu do workspace kodu.
# 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.
Od model skilla do pierwszego wyniku w czterech krokach
Wybierz model
Wybierz model i wariant pasujące do typu wyjścia, progu jakości i celu opóźnienia.
Konfiguracja
Ustaw klucz RunAPI i zainstaluj model skill w workspace kodu.
Implementacja
Użyj instrukcji skilla, aby dodać funkcję modelu w swojej aplikacji.
Odbiór
Odpytuj po task ID, streamuj gdy wspierane albo obsłuż callback webhook.
Czym jest API Suno?
Suno is an AI music generation platform that creates original songs — vocals, instruments, and lyrics — from text descriptions. Through RunAPI, all Suno versions share a single API key with per-call billing.
Dlaczego używać API Suno przez RunAPI
Jedno uwierzytelnienie, wszyscy providerzy
Jeden klucz RunAPI odblokowuje cały katalog. Bez osobnych kont i rotacji kluczy dla każdej integracji.
Ujednolicony cennik i rozliczenia
Rozliczanie za wywołanie w USD, fakturowane co miesiąc. Nieudane generacje nie są naliczane.
Skill ze schematami
Typowane schematy i notatki setupu są spakowane w model skill, więc implementacja startuje od właściwego kontraktu.
Najczęstsze pytania
How long can a generated song be?
Do 8 minut na generację w v4.5 i v5+ (wcześniejsze wersje do 4 minut). Użyj endpointu Extend, aby łączyć segmenty w dłuższe utwory.
Can I provide my own lyrics?
Yes — pass lyrics with [Verse], [Chorus], and [Bridge] tags. You can also let Suno write lyrics from a theme prompt.
How long does generation take?
Typically 30–120 seconds per track. Instrumental-only tracks tend to generate faster.
Can I create instrumental-only tracks?
Yes — set the instrumental flag to true and Suno generates a vocal-free track.
What genres are supported?
Any genre — pop, jazz, lo-fi, classical, metal, hip-hop, electronic, and more. Describe the genre in your prompt.
Od jakiego wariantu powinienem zacząć?
Wybierz najtańszy wariant, który spełnia Twoje wymagania jakościowe. Większość zespołów zaczyna od szybkiego wariantu, a do produkcji przechodzi na pro.
Czy jest darmowy plan?
Nowe konta otrzymują darmowe pierwsze wywołania dla każdego modelu. Później płacisz za każde wywołanie.
Czy streamujecie wyniki?
Tam, gdzie streaming jest dostępny, RunAPI streamuje end-to-end.
Jak są rozliczane nieudane próby?
Nieudane generacje nie są obciążane opłatą.
Czy wyniki są buforowane?
Wygenerowane wyniki są zapisywane i można je pobrać po ID zadania. Dane wejściowe nie są buforowane.
Czy mogę używać komercyjnie?
Tak — użycie komercyjne jest dostępne dla każdego wariantu, chyba że licencja modelu wyraźnie to ogranicza; informacja taka jest podana na stronie wariantu.
A co z limitami zapytań?
Limity na klucz rosną wraz z poziomem wykorzystania. Aktualne limity znajdziesz na stronie cennika.
Gdzie mogę zgłosić problem?
Otwórz zgłoszenie w publicznym repozytorium GitHub albo napisz do supportu.