Hermes Agent'ta 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. Hermes Agent, sohbet için kullanılan aynı API anahtarıyla custom:runapi sağlayıcı üzerinden bunu çağırır.
Use RunAPI to generate a song with Suno.
Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- 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 Hermes Agent'ta Suno kullanın
RunAPI'yi Yapılandır
Hermes Agent'ın çalıştığı ortamda RUNAPI_API_KEY değişkenini ayarlayın. RunAPI'yi zaten custom:runapi sağlayıcı olarak eklediyseniz, aynı anahtar ve base_url Suno müzik isteklerini yönetir.
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. |
Hermes Agent'ta Suno nedir?
Suno, vokaller, enstrümanlar ve prodüksiyonla eksiksiz şarkılar üreten bir metin-müzik üreticisidir. Hermes Agent, otomatik içerik pipeline'larında müzik üretimi adımları için RunAPI custom provider aracılığıyla çağırır.
Suno kullanım senaryoları
Stüdyo prodüksiyonu öncesi şarkı yazımı eskiz defteri
Bir şarkı konseptini açıklayın — tür, atmosfer, tempo, konu — ve tam demo olarak dinleyin.
Yeni stillerde AI kapakları
Mevcut bir parçayı alın ve cover_audio endpoint'i aracılığıyla yeni bir tür veya atmosferde yeniden stilize edin.
Eksiksiz görsel-işitsel içerik pipeline'ları
Bir Hermes Agent iş akışında Suno'yu video modelleriyle zincirleyin — müzik üretin, ardından video, ardından birleştirin.
Suno + Hermes Agent 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.
Hermes Agent yapılandırmasına base_url olarak https://runapi.ai/v1 ve api_key olarak RUNAPI_API_KEY'den okuyan custom:runapi sağlayıcı ekleyin. Aynı sağlayıcı sohbet, görsel, video ve müzik uç noktalarını yönetir — Suno için ayrı yapılandırma gerekmez.
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_mode'u instrumental olarak ayarlayın ve style ile title alanlarını sağlayın. prompt ve lyrics alanları instrumental modunda belirtilmemelidir. API bu çapraz alan kurallarını uygular ve çakışan alanlar gönderilirse doğrulama hatası döndürür.
RunAPI, cover_audio (mevcut bir parçayı yeniden stilize etme), extend_music (bir zaman damgasından şarkıyı devam ettirme), create_mashup (birden fazla parçadan öğeleri birleştirme), text_to_sound (ses efektleri) ve generate_lyrics, generate_persona, separate_audio_stems gibi yardımcı uç noktaları sunar. Tümü aynı API anahtarını ve görev yaşam döngüsünü paylaşır.
Hermes Agent genel kurulum
Henüz yapılandırmadınız mı? Hermes Agent için RunAPI kurulum kılavuzuyla başlayın.
Hermes Agent 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 →Hermes Agent'ta Suno'yu bugün deneyin.
Ücretsiz bir RunAPI anahtarı alın, custom:runapi sağlayıcıyı yapılandırın ve metin açıklamasından vokal, enstrüman ve miksleme içeren tam şarkılar üretin.