---
read_when:
    - برای تبدیل متن به گفتار، Gradium را می‌خواهید
    - به پیکربندی کلید API، صدا یا توکن دستورالعمل Gradium نیاز دارید
summary: استفاده از تبدیل متن به گفتار Gradium در OpenClaw
title: Gradium
x-i18n:
    generated_at: "2026-05-10T20:03:15Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5c79da6ec63532061a8112965a679f1113bbefcc91ee00def8153dd39b5b5e58
    source_path: providers/gradium.md
    workflow: 16
---

[Gradium](https://gradium.ai) یک ارائه‌دهنده متن‌به‌گفتار همراه برای OpenClaw است. این Plugin می‌تواند پاسخ‌های صوتی معمولی (WAV)، خروجی Opus سازگار با یادداشت صوتی، و صدای 8 kHz u-law را برای سطوح تلفنی تولید کند.

| ویژگی      | مقدار                                |
| ------------- | ------------------------------------ |
| شناسه ارائه‌دهنده   | `gradium`                            |
| احراز هویت          | `GRADIUM_API_KEY` یا پیکربندی `apiKey` |
| نشانی پایه      | `https://api.gradium.ai` (پیش‌فرض)   |
| صدای پیش‌فرض | `Emma` (`YTpq7expH9539ERJ`)          |

## راه‌اندازی

یک کلید API برای Gradium بسازید، سپس آن را با یک متغیر محیطی یا کلید پیکربندی در اختیار OpenClaw قرار دهید.

<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 ابتدا `apiKey` حل‌شده را بررسی می‌کند و در صورت نبود آن، به متغیر محیطی `GRADIUM_API_KEY` برمی‌گردد.

## پیکربندی

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

| کلید                                      | نوع   | توضیح                                                                                   |
| ---------------------------------------- | ------ | --------------------------------------------------------------------------------------------- |
| `messages.tts.providers.gradium.apiKey`  | string | کلید API حل‌شده. از `${ENV}` و ارجاع‌های محرمانه پشتیبانی می‌کند.                                          |
| `messages.tts.providers.gradium.baseUrl` | string | مبدا API را بازنویسی می‌کند. اسلش‌های انتهایی حذف می‌شوند. مقدار پیش‌فرض `https://api.gradium.ai` است. |
| `messages.tts.providers.gradium.voiceId` | string | شناسه صدای پیش‌فرض که وقتی بازنویسی دستوری وجود ندارد استفاده می‌شود.                                  |

قالب صدای خروجی به‌صورت خودکار توسط runtime بر اساس سطح مقصد انتخاب می‌شود و از `openclaw.json` قابل پیکربندی نیست. بخش [خروجی](#output) را در ادامه ببینید.

## صداها

| نام      | شناسه صدا           |
| --------- | ------------------ |
| Emma      | `YTpq7expH9539ERJ` |
| Kent      | `LFZvm12tW_z0xfGo` |
| Tiffany   | `Eu9iL_CYe8N-Gkx_` |
| Christina | `2H4HY2CBNyJHBCrP` |
| Sydney    | `jtEKaLYNn6iif5PR` |
| John      | `KWJiFWu2O9nMPYcR` |
| Arthur    | `3jUdJyOi9pgbxBTK` |

صدای پیش‌فرض: Emma.

### بازنویسی صدا برای هر پیام

وقتی سیاست گفتار فعال اجازه بازنویسی صدا را می‌دهد، می‌توانید با استفاده از یک توکن دستوری، صداها را به‌صورت درون‌خطی تغییر دهید. همه این‌ها به همان بازنویسی `voiceId` حل می‌شوند:

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

اگر سیاست گفتار بازنویسی صدا را غیرفعال کرده باشد، دستور مصرف می‌شود اما نادیده گرفته می‌شود.

## خروجی

runtime قالب خروجی را از سطح مقصد انتخاب می‌کند. این ارائه‌دهنده در حال حاضر قالب‌های دیگری تولید نمی‌کند.

| مقصد         | قالب      | پسوند فایل | نرخ نمونه‌برداری | پرچم سازگار با صدا |
| -------------- | ----------- | -------- | ----------- | --------------------- |
| صدای استاندارد | `wav`       | `.wav`   | ارائه‌دهنده    | خیر                    |
| یادداشت صوتی     | `opus`      | `.opus`  | ارائه‌دهنده    | بله                   |
| تلفنی      | `ulaw_8000` | n/a      | 8 kHz       | n/a                   |

## ترتیب انتخاب خودکار

در میان ارائه‌دهندگان TTS پیکربندی‌شده، ترتیب انتخاب خودکار Gradium برابر با `30` است. برای اینکه ببینید OpenClaw وقتی `messages.tts.provider` ثابت نشده باشد چگونه ارائه‌دهنده فعال را انتخاب می‌کند، [متن‌به‌گفتار](/fa/tools/tts) را ببینید.

## مرتبط

- [متن‌به‌گفتار](/fa/tools/tts)
- [نمای کلی رسانه](/fa/tools/media-overview)