---
read_when:
    - Você quer usar o Gradium para conversão de texto em fala
    - Você precisa de uma chave de API da Gradium, voz ou configuração de token de diretiva
summary: Use a conversão de texto em fala da Gradium no OpenClaw
title: Gradium
x-i18n:
    generated_at: "2026-05-10T19:47:46Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5c79da6ec63532061a8112965a679f1113bbefcc91ee00def8153dd39b5b5e58
    source_path: providers/gradium.md
    workflow: 16
---

[Gradium](https://gradium.ai) é um provedor de texto para fala incluído no OpenClaw. O Plugin pode renderizar respostas de áudio normais (WAV), saída Opus compatível com notas de voz e áudio u-law de 8 kHz para superfícies de telefonia.

| Propriedade   | Valor                                |
| ------------- | ------------------------------------ |
| ID do provedor | `gradium`                            |
| Autenticação  | `GRADIUM_API_KEY` ou config `apiKey` |
| URL base      | `https://api.gradium.ai` (padrão)    |
| Voz padrão    | `Emma` (`YTpq7expH9539ERJ`)          |

## Configuração

Crie uma chave de API do Gradium e, em seguida, exponha-a ao OpenClaw com uma variável de ambiente ou com a chave de configuração.

<Tabs>
  <Tab title="Variável de ambiente">
    ```bash
    export GRADIUM_API_KEY="gsk_..."
    ```
  </Tab>

  <Tab title="Chave de configuração">
    ```json5
    {
      messages: {
        tts: {
          auto: "always",
          provider: "gradium",
          providers: {
            gradium: {
              apiKey: "${GRADIUM_API_KEY}",
            },
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>

O Plugin verifica primeiro o `apiKey` resolvido e recorre à variável de ambiente `GRADIUM_API_KEY`.

## Configuração

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

| Chave                                    | Tipo   | Descrição                                                                                   |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------- |
| `messages.tts.providers.gradium.apiKey`  | string | Chave de API resolvida. Compatível com `${ENV}` e referências de segredo.                   |
| `messages.tts.providers.gradium.baseUrl` | string | Substitui a origem da API. Barras finais são removidas. O padrão é `https://api.gradium.ai`. |
| `messages.tts.providers.gradium.voiceId` | string | ID de voz padrão usado quando nenhuma substituição por diretiva está presente.              |

O formato de áudio de saída é selecionado automaticamente pelo runtime com base na superfície de destino e não é configurável em `openclaw.json`. Veja [Saída](#output) abaixo.

## Vozes

| Nome      | ID da voz           |
| --------- | ------------------- |
| Emma      | `YTpq7expH9539ERJ`  |
| Kent      | `LFZvm12tW_z0xfGo`  |
| Tiffany   | `Eu9iL_CYe8N-Gkx_`  |
| Christina | `2H4HY2CBNyJHBCrP`  |
| Sydney    | `jtEKaLYNn6iif5PR`  |
| John      | `KWJiFWu2O9nMPYcR`  |
| Arthur    | `3jUdJyOi9pgbxBTK`  |

Voz padrão: Emma.

### Substituição de voz por mensagem

Quando a política de fala ativa permite substituições de voz, você pode trocar de voz inline usando um token de diretiva. Todas estas opções resolvem para a mesma substituição de `voiceId`:

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

Se a política de fala desabilitar substituições de voz, a diretiva será consumida, mas ignorada.

## Saída

O runtime escolhe o formato de saída a partir da superfície de destino. Atualmente, o provedor não sintetiza outros formatos.

| Destino       | Formato     | Ext. do arquivo | Taxa de amostragem | Sinalizador compatível com voz |
| ------------- | ----------- | --------------- | ------------------ | ------------------------------ |
| Áudio padrão  | `wav`       | `.wav`          | provedor           | não                            |
| Nota de voz   | `opus`      | `.opus`         | provedor           | sim                            |
| Telefonia     | `ulaw_8000` | n/a             | 8 kHz              | n/a                            |

## Ordem de seleção automática

Entre os provedores de TTS configurados, a ordem de seleção automática do Gradium é `30`. Veja [Texto para fala](/pt-BR/tools/tts) para saber como o OpenClaw escolhe o provedor ativo quando `messages.tts.provider` não está fixado.

## Relacionados

- [Texto para fala](/pt-BR/tools/tts)
- [Visão geral de mídia](/pt-BR/tools/media-overview)