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

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

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

### Hangi Suno sürümünü kullanmalıyım?

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.

### Suno üretimi ne kadar sürer?

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

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

### Ses cinsiyetini ve stil ağırlığını kontrol edebilir miyim?

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.


## Links

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