Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.
WorkBuddy'de Suno kullanın.
Suno, bir metin prompt'undan veya tam şarkı sözlerinden — vokaller, enstrümanlar ve miksaj dahil — tam şarkılar oluşturur. Suno'nun resmi bir genel API'si olmadığından RunAPI aracılığıyla v4'ten v5.5'e kadar sürümler mevcuttur. RunAPI'yi bir kez MCP sunucusu olarak ekleyin; WorkBuddy agent async görevi yönetir ve bitmiş ses URL'sini geri döndürür.
Using the runapi MCP server, generate a song with Suno.
Requirements:
- Call the Suno text_to_music tool exposed by the runapi MCP server.
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" so the lyrics are written from my brief.
- Prompt: an upbeat indie pop track about coding late at night,
warm synths and acoustic guitar, female vocals.
- The task is async — keep polling until the status is "completed",
then give me the audio URL.
{
"mcp_servers": {
"runapi": {
"url": "https://runapi.ai/mcp",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer $RUNAPI_API_KEY"
}
}
}
}
{
"task_id": "tsk_abc123",
"status": "completed",
"model": "suno-v5.5",
"output": {
"audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3",
"title": "Midnight Compile",
"duration_seconds": 187
}
}
WorkBuddy'de Suno'yu üç adımda kullanın
RunAPI'yi MCP server olarak ekleyin
WorkBuddy'i başlatan ortamda RUNAPI_API_KEY'i ayarlayın, ardından streamable HTTP üzerinden https://runapi.ai/mcp adresini işaret eden runapi adlı bir MCP sunucusu kaydedin. Suno, diğer tüm RunAPI modelleriyle birlikte çağrılabilir bir müzik aracı olarak görünür — ayrı bir müzik servisi bağlamaya gerek yoktur.
export RUNAPI_API_KEY=runapi_xxx
# MCP server: runapi → https://runapi.ai/mcp
Şarkıyı agent'a tarif edin
WorkBuddy'e ne istediğinizi sade dille anlatın ve modu belirtin. Yapay zeka tarafından yazılan sözler için prompt ile auto_lyrics, kendi sözleriniz için lyrics/style/title ile exact_lyrics veya vokal olmaması için style/title ile instrumental kullanın. Agent, özet açıklamanızı Suno araç çağrısına eşler.
vocal_mode: auto_lyrics
Agent'ın yoklamasına ve sesi toplamasına izin verin
Şarkı oluşturma asenkrondur ve sürüme bağlı olarak 30 saniyeden birkaç dakikaya kadar sürer. Workbench agent, görev durum tamamlandı olana kadar yoklar, ardından çıktı ses URL'sini konuşmaya gönderir — siz hiçbir zaman task_id ile uğraşmazsınız.
"status": "completed"
Suno text_to_music parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
model |
string |
Zorunlu. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 veya suno-v5.5. |
vocal_mode |
string |
Zorunlu. auto_lyrics (yapay zeka prompt'tan sözler yazar), exact_lyrics (sözleri/stili/başlığı siz sağlarsınız) veya instrumental (vokal yok, stil/başlık gerektirir). |
prompt |
string |
auto_lyrics modu için şarkı özeti. Tür, ruh hali, tempo ve konuyu açıklayın. exact_lyrics ve instrumental modlarında yasaktır. |
lyrics |
string |
Söylenecek tam sözler. exact_lyrics modu için zorunludur. auto_lyrics ve instrumental modlarında yasaktır. |
style |
string |
Müzik stili açıklaması, örn. lo-fi hip hop, 80'ler synthwave. exact_lyrics ve instrumental modları için zorunludur. |
vocal_gender |
string |
İsteğe bağlı. male veya female. |
negative_tags |
string |
İsteğe bağlı. Kaçınılacak stiller, örn. heavy metal, screaming. |
WorkBuddy'de Suno nedir?
Suno, bir metin prompt'undan veya kendi şarkı sözlerinizden — vokaller, enstrümanlar ve miksaj dahil — tam şarkılar oluşturan bir metinden müziğe yapay zekasıdır. Türü, ruh halini ve tempoyu tarif ettiğinizde tam bir parça elde ettiğiniz bir şarkı yazma taslak panosu gibi çalışır. Suno'nun resmi bir genel API'si olmadığından WorkBuddy, RunAPI MCP sunucusu aracılığıyla ona erişir; bu sayede workbench agent, sohbet ve görseller için kullandığı aynı anahtarla v4'ten v5.5'e kadar sürümlere programatik erişim elde eder.
Suno kullanım senaryoları
YouTube ve sosyal medya için arka plan müziği
Workbench agent'tan ruh halini ve türü tarif ederek orijinal arka plan parçaları isteyin. Lisans ücreti yok, telif hakkı sorunu yok — parça içeriğiniz için sıfırdan oluşturulur ve URL WorkBuddy'e geri döner.
Sözleri tam bir şarkı olarak dinleme
Söz yazarları, sözlerini WorkBuddy'ye yapıştırabilir ve tam bir şarkı olarak seslendirilmelerini duymak için bir stil açıklamasıyla exact_lyrics modunu isteyebilir — stüdyo zamanından önce bir prodüksiyon demosu.
Podcast giriş ve çıkışları
Tür, ruh hali ve süre belirterek bir podcast'in tonuyla eşleşen enstrümantal giriş ve çıkış müziği oluşturun. Agent'tan tek bir konuşmada birkaç varyasyon oluşturmasını isteyin ve en uygun olanı seçin.
Suno + WorkBuddy soruları
WorkBuddy'e verdiğiniz açıklamada tür, ruh hali, tempo ve enstrümantasyon hakkında spesifik olun. Örneğin, "mutlu şarkı" yerine "akustik gitar ve sıcak synthler içeren enerjik 120 BPM indie pop" daha iyi sonuç verir. Agent'tan istenmeyen heavy metal veya bağırma gibi unsurları dışlamak için negative_tags geçmesini isteyin.
suno-v5.5 en güncel sürümdür ve daha iyi vokal netliği ve miksajla en yüksek kalitede çıktı üretir. suno-v4 ve suno-v4.5 taslak yinelemeler için daha ucuz ve hızlıdır. Tüm sürümler aynı runapi MCP sunucusunun arkasında yer alır, bu nedenle geçiş yapmak için prompt'unuzda farklı bir sürüm adı belirtmeniz yeterlidir.
Hayır. Suno görevleri asenkrondur, ancak workbench agent yaşam döngüsünü yönetir — MCP aracı aracılığıyla görevi oluşturur, durum tamamlandı olana kadar yoklar ve ses URL'sini konuşmaya gönderir. Siz sadece şarkıyı tarif edip bekliyorsunuz.
Suno, herkese açık bir API sunmamaktadır. RunAPI, diğer tüm RunAPI modelleri için kullanılan aynı API anahtarı ve görev yaşam döngüsü aracılığıyla Suno v4'ten v5.5'e programatik erişim sağlar. Suno hesabına veya ayrı kimlik bilgilerine gerek yoktur.
Evet. vocal_gender olarak male veya female isteyin ve istenmeyen stilleri dışlamak için negative_tags kullanın. Daha ince ayar için personas endpoint'i aracılığıyla bir kişilik oluşturun ve döndürülen persona_id'yi persona_type olarak voice veya style ayarlanmış şekilde geçirin.
WorkBuddy genel kurulum
Henüz bağlı değil misiniz? WorkBuddy için RunAPI MCP kurulum kılavuzuyla başlayın.
WorkBuddy kurulum kılavuzu →Suno model kataloğu
Tüm Suno sürümlerini, fiyatlandırmayı ve mevcut endpoint'leri inceleyin.
RunAPI'de Suno →Bugün WorkBuddy'de Suno'yu deneyin.
Ücretsiz bir RunAPI anahtarı alın, MCP sunucusunu WorkBuddy'e ekleyin ve bir şarkı tarif edin — workbench agent vokaller, enstrümanlar ve miksajla tam bir parça döndürür.