---
title: "Hermes Agent'ta RunAPI ile Suno Kullanımı — Müzik API Kılavuzu"
url: "https://runapi.ai/tr/hermes-suno.md"
canonical: "https://runapi.ai/tr/hermes-suno"
locale: "tr"
model: "suno"
---

# 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.

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

```

## How it works

1. **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.
2. **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.
3. **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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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. |

## FAQ

### auto_lyrics, exact_lyrics ve instrumental arasındaki fark nedir?

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'ta Suno için RunAPI'yi özel sağlayıcı olarak nasıl yapılandırırım?

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.

### RunAPI resmi bir Suno API'si mi sunuyor?

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.

### Vokal olmadan sadece enstrümantal parçalar üretebilir miyim?

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.

### text_to_music dışında başka hangi Suno uç noktaları mevcut?

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.


## Links

- [Hermes Agent kurulum kılavuzu →](https://runapi.ai/tr/hermes-agent)
- [RunAPI'de Suno →](https://runapi.ai/tr/models/suno)
- [Model catalog](https://runapi.ai/tr/models)
- [API docs](https://runapi.ai/tr/docs)