OpenClaw'da Suno kullanın.
Suno, bir metin isteminden veya tam sözlerden vokal, enstrüman ve miksleme dahil tam şarkılar üretir. v4'ten v5.5'e kadar olan sürümler RunAPI üzerinden kullanılabilir; Suno'nun resmi bir genel API'si olmadığı için RunAPI, API erişimi sağlar. OpenClaw ajanları, sohbet için kullanılan aynı RUNAPI_API_KEY ile bunu çağırır.
Use RunAPI to generate a song with Suno.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/suno/text_to_music
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" for AI-generated lyrics from a prompt.
- Set prompt to describe the song you want.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.
curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v5.5",
"vocal_mode": "auto_lyrics",
"prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
"vocal_gender": "female"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "suno-v5.5"
}
Üç adımda OpenClaw'da Suno kullanın
RunAPI'yi Yapılandır
Ortamınızda RUNAPI_API_KEY değişkenini ayarlayın. OpenClaw'da sohbet için RunAPI'yi zaten yapılandırdıysanız, aynı anahtar Suno müzik üretimi için de çalışır — ek sağlayıcı kurulumu gerekmez.
export RUNAPI_API_KEY=runapi_xxx
text_to_music'i çağır
text_to_music uç noktasına model ve vocal_mode ile POST gönderin. Yapay zeka tarafından yazılan sözler için auto_lyrics ile istem, kendi sözleriniz için exact_lyrics ile lyrics/style/title, vokal olmadan instrumental ile style/title kullanın.
POST /api/v1/suno/text_to_music
Sonucu Al
Uç nokta hemen bir task_id döndürür. Şarkı üretimi sürüme bağlı olarak 30 saniyeden birkaç dakikaya kadar sürer. Durum tamamlandı olana kadar görev durumu uç noktasını sorgulayın, ardından çıktı ses URL'sini okuyun.
GET /api/v1/suno/text_to_music/tsk_abc123
Suno text_to_music API parametreleri
| Parametre | Tür | Açıklama |
|---|---|---|
model |
string |
Gerekli. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5 veya suno-v5.5. |
vocal_mode |
string |
Gerekli. auto_lyrics (yapay zeka istemden söz yazar), exact_lyrics (siz söz/stil/başlık 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 tanımlayın. exact_lyrics ve instrumental modlarında kullanılamaz. |
lyrics |
string |
Söylenecek tam sözler. exact_lyrics modu için gereklidir. auto_lyrics ve instrumental modlarında kullanılamaz. |
style |
string |
Müzik stili açıklaması, ör. lo-fi hip hop, 80s synthwave. exact_lyrics ve instrumental modları için gereklidir. |
title |
string |
Şarkı başlığı. exact_lyrics ve instrumental modları için gereklidir. |
vocal_gender |
string |
İsteğe bağlı. male veya female. |
negative_tags |
string |
İsteğe bağlı. Kaçınılacak stiller, ör. heavy metal, screaming. |
duration_seconds |
integer |
İsteğe bağlı. Saniye cinsinden hedef süre. |
persona_id |
string |
İsteğe bağlı. Özel ses veya stil profilleri için Persona ID. |
persona_type |
string |
İsteğe bağlı. style veya voice. Persona kategorisini seçer. |
callback_url |
string |
İsteğe bağlı. Görev tamamlandığında POST alan webhook URL'si. |
OpenClaw'da Suno nedir?
Suno, metin komutundan vokaller, enstrümanlar ve prodüksiyonla eksiksiz şarkılar üreten bir metin-müzik AI'dır. Tam sözler modu, uzun şarkılar için sürekli üretim ve tür güdümlü kompozisyonu destekler. OpenClaw ajanları, sohbette kullanılan aynı API anahtarıyla RunAPI aracılığıyla çağırır.
Suno kullanım senaryoları
YouTube ve sosyal medya için arka plan müziği
Tür, atmosfer ve tempoyu açıklayarak videolar için orijinal arka plan parçaları üretin.
Şarkı sözlerini eksiksiz şarkı olarak dinleme
Söz yazarları kelimelerini exact_lyrics moduna yapıştırarak bunların eksiksiz şarkı olarak nasıl çıktığını duyabilir.
Podcast intro ve outro'ları
Bir podcastin atmosferi ve formatıyla eşleşen enstrümantal intro ve outro müziği oluşturun.
Suno + OpenClaw soruları
auto_lyrics, isteminizden söz üretir — şarkıyı tanımlarsınız, Suno kelimeleri yazar. exact_lyrics, sağladığınız sözleri birebir kullanır ve style ile title alanlarını gerektirir. instrumental, yalnızca style ve title kullanarak vokal olmadan bir parça üretir.
suno-v5.5 en son sürümdür ve daha iyi vokal netliği ve miksleme ile en yüksek kalitede çıktı üretir. suno-v4 ve suno-v4.5, taslak iterasyonlar için daha ucuz ve hızlıdır. Tüm sürümler aynı text_to_music uç noktasını ve parametrelerini kullanır.
Üretim süresi sürüm ve şarkı uzunluğuna göre değişir. Tipik süre 30 saniye ile 2 dakika arasındadır. API hemen bir task_id döndürür — ajanınızı engellemekten kaçınmak için durum uç noktasını sorgulayın veya callback_url ayarlayın.
Suno'nun genel bir API'si yoktur. RunAPI, diğer tüm RunAPI modelleri için kullanılan aynı API anahtarı ve görev yaşam döngüsü üzerinden Suno v4'ten v5.5'e programatik erişim sağlar. Suno hesabı veya ayrı kimlik bilgileri gerekmez.
Evet. vocal_gender'ı male veya female olarak ayarlayın. İstenmeyen stilleri hariç tutmak için negative_tags kullanın. Daha ince kontrol için generate_persona uç noktası aracılığıyla bir persona oluşturun ve döndürülen persona_id'yi persona_type olarak voice veya style ile birlikte gönderin.
OpenClaw genel kurulum
Henüz yapılandırmadınız mı? OpenClaw için RunAPI kurulum kılavuzuyla başlayın.
OpenClaw kurulum kılavuzu →Suno model kataloğu
Tüm Suno sürümlerini, fiyatlandırmayı ve mevcut uç noktaları görün.
RunAPI'de Suno →OpenClaw'da Suno'yu bugün deneyin.
Ücretsiz bir RunAPI anahtarı alın, istemi OpenClaw'a yapıştırın ve metin açıklamasından vokal, enstrüman ve miksleme içeren tam şarkılar üretin.