> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gradium

[Gradium](https://gradium.ai) — це провайдер перетворення тексту на мовлення для OpenClaw. Plugin може створювати звичайні аудіовідповіді (WAV), сумісний із голосовими нотатками вивід Opus та аудіо 8 kHz u-law для телефонних поверхонь.

| Властивість              | Значення                              |
| ------------------------ | ------------------------------------- |
| Ідентифікатор провайдера | `gradium`                             |
| Автентифікація           | `GRADIUM_API_KEY` або config `apiKey` |
| Базова URL-адреса        | `https://api.gradium.ai` (типово)     |
| Голос за замовчуванням   | `Emma` (`YTpq7expH9539ERJ`)           |

## Установлення Plugin

Установіть офіційний Plugin, потім перезапустіть Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart
```

## Налаштування

Створіть API-ключ Gradium, потім надайте його OpenClaw через змінну середовища або ключ конфігурації.

<Tabs>
  <Tab title="Змінна середовища">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export GRADIUM_API_KEY="gsk_..."
    ```
  </Tab>

  <Tab title="Ключ конфігурації">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      messages: {
        tts: {
          auto: "always",
          provider: "gradium",
          providers: {
            gradium: {
              apiKey: "${GRADIUM_API_KEY}",
            },
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>

Plugin спочатку перевіряє розв’язаний `apiKey`, а потім повертається до змінної середовища `GRADIUM_API_KEY`.

## Конфігурація

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "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.speakerVoiceId` | string | Ідентифікатор голосу за замовчуванням, який використовується, коли немає перевизначення директивою. |

Формат вихідного аудіо автоматично вибирається середовищем виконання на основі цільової поверхні й не налаштовується з `openclaw.json`. Див. [Вивід](#output) нижче.

## Голоси

| Ім’я      | Ідентифікатор голосу |
| --------- | -------------------- |
| Emma      | `YTpq7expH9539ERJ`   |
| Kent      | `LFZvm12tW_z0xfGo`   |
| Tiffany   | `Eu9iL_CYe8N-Gkx_`   |
| Christina | `2H4HY2CBNyJHBCrP`   |
| Sydney    | `jtEKaLYNn6iif5PR`   |
| John      | `KWJiFWu2O9nMPYcR`   |
| Arthur    | `3jUdJyOi9pgbxBTK`   |

Голос за замовчуванням: Emma.

### Перевизначення голосу для окремого повідомлення

Коли активна політика мовлення дозволяє перевизначення голосу, ви можете перемикати голоси вбудовано за допомогою токена директиви. Використовуйте `speakerVoiceId` для нативних ідентифікаторів голосу провайдера.

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
```

Якщо політика мовлення вимикає перевизначення голосу, директива споживається, але ігнорується.

## Вивід

Середовище виконання вибирає формат виводу з цільової поверхні. Наразі провайдер не синтезує інші формати.

| Ціль             | Формат      | Розширення файлу | Частота дискретизації | Прапорець сумісності з голосом |
| ---------------- | ----------- | ---------------- | --------------------- | ------------------------------ |
| Стандартне аудіо | `wav`       | `.wav`           | провайдер             | ні                             |
| Голосова нотатка | `opus`      | `.opus`          | провайдер             | так                            |
| Телефонія        | `ulaw_8000` | n/a              | 8 kHz                 | n/a                            |

## Порядок автоматичного вибору

Серед налаштованих TTS-провайдерів порядок автоматичного вибору Gradium — `30`. Див. [Перетворення тексту на мовлення](/uk/tools/tts), щоб дізнатися, як OpenClaw вибирає активного провайдера, коли `messages.tts.provider` не закріплено.

## Пов’язане

* [Перетворення тексту на мовлення](/uk/tools/tts)
* [Огляд медіа](/uk/tools/media-overview)