---
read_when:
    - Metinden konuşmaya dönüştürme için Gradium istiyorsunuz
    - Gradium API anahtarı, ses veya direktif belirteci yapılandırmasına ihtiyacınız var
summary: OpenClaw'da Gradium metinden sese dönüştürmeyi kullanın
title: Gradium
x-i18n:
    generated_at: "2026-05-10T19:52:04Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5c79da6ec63532061a8112965a679f1113bbefcc91ee00def8153dd39b5b5e58
    source_path: providers/gradium.md
    workflow: 16
---

[Gradium](https://gradium.ai), OpenClaw için paketle birlikte gelen bir metinden sese sağlayıcısıdır. Plugin normal sesli yanıtları (WAV), sesli not uyumlu Opus çıktısını ve telefon yüzeyleri için 8 kHz u-law sesi oluşturabilir.

| Özellik       | Değer                                |
| ------------- | ------------------------------------ |
| Sağlayıcı id  | `gradium`                            |
| Kimlik doğrulama | `GRADIUM_API_KEY` veya config `apiKey` |
| Temel URL     | `https://api.gradium.ai` (varsayılan) |
| Varsayılan ses | `Emma` (`YTpq7expH9539ERJ`)          |

## Kurulum

Bir Gradium API anahtarı oluşturun, ardından bunu bir ortam değişkeni veya config anahtarıyla OpenClaw'a sunun.

<Tabs>
  <Tab title="Env var">
    ```bash
    export GRADIUM_API_KEY="gsk_..."
    ```
  </Tab>

  <Tab title="Config key">
    ```json5
    {
      messages: {
        tts: {
          auto: "always",
          provider: "gradium",
          providers: {
            gradium: {
              apiKey: "${GRADIUM_API_KEY}",
            },
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>

Plugin önce çözümlenen `apiKey` değerini denetler ve ardından `GRADIUM_API_KEY` ortam değişkenine geri döner.

## Config

```json5
{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          voiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
```

| Anahtar                                 | Tür    | Açıklama                                                                                   |
| --------------------------------------- | ------ | ------------------------------------------------------------------------------------------ |
| `messages.tts.providers.gradium.apiKey`  | string | Çözümlenen API anahtarı. `${ENV}` ve gizli referansları destekler.                         |
| `messages.tts.providers.gradium.baseUrl` | string | API kökenini geçersiz kılar. Sondaki eğik çizgiler kaldırılır. Varsayılan değer `https://api.gradium.ai` olur. |
| `messages.tts.providers.gradium.voiceId` | string | Yönerge geçersiz kılması bulunmadığında kullanılan varsayılan ses id'si.                   |

Çıkış ses biçimi, hedef yüzeye göre çalışma zamanı tarafından otomatik olarak seçilir ve `openclaw.json` üzerinden yapılandırılamaz. Aşağıdaki [Çıktı](#output) bölümüne bakın.

## Sesler

| Ad        | Ses ID'si          |
| --------- | ------------------ |
| Emma      | `YTpq7expH9539ERJ` |
| Kent      | `LFZvm12tW_z0xfGo` |
| Tiffany   | `Eu9iL_CYe8N-Gkx_` |
| Christina | `2H4HY2CBNyJHBCrP` |
| Sydney    | `jtEKaLYNn6iif5PR` |
| John      | `KWJiFWu2O9nMPYcR` |
| Arthur    | `3jUdJyOi9pgbxBTK` |

Varsayılan ses: Emma.

### İleti başına ses geçersiz kılması

Etkin konuşma ilkesi ses geçersiz kılmalarına izin verdiğinde, bir yönerge belirteci kullanarak satır içinde sesleri değiştirebilirsiniz. Bunların tümü aynı `voiceId` geçersiz kılmasına çözümlenir:

```text
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
```

Konuşma ilkesi ses geçersiz kılmalarını devre dışı bırakırsa yönerge tüketilir, ancak yok sayılır.

## Çıktı

Çalışma zamanı çıkış biçimini hedef yüzeyden seçer. Sağlayıcı bugün başka biçimler sentezlemez.

| Hedef          | Biçim       | Dosya uzantısı | Örnekleme hızı | Ses uyumluluğu bayrağı |
| -------------- | ----------- | -------------- | -------------- | ---------------------- |
| Standart ses   | `wav`       | `.wav`         | sağlayıcı      | hayır                  |
| Sesli not      | `opus`      | `.opus`        | sağlayıcı      | evet                   |
| Telefon        | `ulaw_8000` | yok            | 8 kHz          | yok                    |

## Otomatik seçim sırası

Yapılandırılmış TTS sağlayıcıları arasında Gradium'un otomatik seçim sırası `30` değeridir. `messages.tts.provider` sabitlenmediğinde OpenClaw'ın etkin sağlayıcıyı nasıl seçtiği için [Metinden Sese](/tr/tools/tts) bölümüne bakın.

## İlgili

- [Metinden Sese](/tr/tools/tts)
- [Medya Genel Bakışı](/tr/tools/media-overview)