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.
- Farklı hız / kalite seviyeleri için birden çok varyant
- Model skill dokümanları, şemaları ve kurulum notlarını içerir
- Uygulama odaklı kodlama workflow’larıyla çalışır
- Başarısız üretimler ücretlendirilmez
Tüm API varyantlarını karşılaştırın
Utility endpoints
Shared endpoints for this model line, such as extension, enhancement, or conversion actions.
Uygulama geliştirme için Suno skill’ini kurun
Model dokümanlarını, şemaları, fiyat notlarını ve kurulum adımlarını kod workspace’inize yükleyin.
# 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.
Model skill’den ilk sonuca dört adımda
Modeli seçin
Çıktı tipi, kalite eşiği ve gecikme hedefinize uygun model ve varyantı seçin.
Yapılandır
RunAPI anahtarınızı ayarlayın ve model skill’i kod workspace’inize kurun.
Geliştirin
Skill talimatlarını kullanarak model özelliğini uygulamanızın içine ekleyin.
Al
Task ID ile sorgulayın, destekleniyorsa stream edin veya webhook callback’i işleyin.
Suno API nedir?
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.
Suno API neden RunAPI üzerinden kullanılmalı
Tek kimlik doğrulama, tüm sağlayıcılar
Tek bir RunAPI anahtarı tüm kataloğu açar. Ayrı hesap yok, her entegrasyon için anahtar döndürme yok.
Birleşik fiyatlandırma ve faturalandırma
USD bazında çağrı başı fiyatlandırma, aylık faturalandırılır. Başarısız üretimler ücretlendirilmez.
Şemalı skill
Tipli şemalar ve kurulum notları model skill içinde paketlenir; uygulama doğru kontrattan başlar.
Sık sorulan sorular
How long can a generated song be?
v4.5 ve v5+ sürümlerinde nesil başına 8 dakikaya kadar (önceki sürümlerde 4 dakikaya kadar). Daha uzun parçalar için Extend endpoint'ini kullanarak segmentleri zincirleyin.
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.
Hangi varyantla başlamalıyım?
Kalite beklentinizi karşılayan en uygun fiyatlı varyantı seçin. Çoğu ekip hızlı varyantla başlar ve üretimde pro sürüme geçer.
Ücretsiz bir katman var mı?
Yeni hesaplar her modelde ilk çağrıları ücretsiz alır. Sonrasında çağrı başına ödeme yaparsınız.
Sonuçları streaming olarak sunuyor musunuz?
Streaming desteklendiğinde RunAPI uçtan uca streaming sağlar.
Başarısız işlemler nasıl ücretlendirilir?
Başarısız üretimler ücretlendirilmez.
Çıktılar önbelleğe alınıyor mu?
Üretilen çıktılar saklanır ve görev ID’siyle geri alınabilir. Girdiler önbelleğe alınmaz.
Ticari kullanım yapabilir miyim?
Evet — bir model lisansı bunu açıkça kısıtlamadıkça ticari kullanım tüm varyantlarda dahildir; kısıtlamalar varyant sayfasında belirtilir.
Oran limitleri ne durumda?
Anahtar bazlı oran limitleri kullanım kademesine göre ölçeklenir. Güncel limitler için fiyatlandırma sayfasına bakın.
Sorunları nereye bildirebilirim?
Herkese açık GitHub reposunda bir issue açın veya destek ekibine e-posta gönderin.