Gradium

Gradium은 OpenClaw용 텍스트 음성 변환 제공업체입니다. 표준 오디오 응답(WAV), 음성 메모와 호환되는 Opus 출력, 전화 통신 인터페이스용 8 kHz u-law 오디오를 렌더링합니다.

속성	값
제공업체 ID	`gradium`
인증	`GRADIUM_API_KEY` 또는 구성 `apiKey`
기본 URL	`https://api.gradium.ai` (기본값)
기본 음성	`Emma` (`YTpq7expH9539ERJ`)

Plugin 설치

Gradium은 공식 외부 Plugin입니다. 설치한 후 Gateway를 다시 시작하십시오.

openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

설정

Gradium API 키를 생성한 후 환경 변수 또는 구성 키로 제공하십시오. 구성 값이 환경 변수보다 우선합니다.

환경 변수
구성 키

export GRADIUM_API_KEY="gsk_..."

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          apiKey: "${GRADIUM_API_KEY}",
        },
      },
    },
  },
}

구성

{
  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.gradium.ai`의 HTTPS Gradium API URL입니다. 후행 슬래시는 제거됩니다. 기본값은 `https://api.gradium.ai`입니다.
`messages.tts.providers.gradium.speakerVoiceId`	string	지시어 재정의가 없을 때 사용하는 기본 음성 ID입니다.

출력 형식은 대상 인터페이스에 따라 자동으로 선택되며(출력 참조), openclaw.json에서 구성할 수 없습니다.

음성

이름	음성 ID
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (기본값)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

메시지별 음성 재정의

활성 음성 정책에서 음성 재정의를 허용하는 경우 지시어 토큰을 사용하여 인라인으로 음성을 전환할 수 있습니다(다음 토큰은 모두 동일하며 제공업체 네이티브 음성 ID를 받습니다).

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

음성 정책에서 음성 재정의를 비활성화하면 지시어가 소비되지만 무시됩니다.

출력

출력 형식은 대상 인터페이스에 따라 선택되며, 제공업체는 다른 형식을 합성하지 않습니다.

대상	형식	파일 확장자	샘플링 레이트	음성 호환 플래그
표준 오디오	`wav`	`.wav`	제공업체	아니요
음성 메모	`opus`	`.opus`	제공업체	예
전화 통신	`ulaw_8000`	해당 없음	8 kHz	해당 없음

자동 선택 순서

구성된 TTS 제공업체 중 Gradium의 자동 선택 순서는 30입니다. messages.tts.provider가 고정되지 않았을 때 OpenClaw가 활성 제공업체를 선택하는 방법은 텍스트 음성 변환을 참조하십시오.

Overview

Concepts and configuration

Providers

Plugin 설치

설정

구성

음성

메시지별 음성 재정의

출력

자동 선택 순서

관련 문서

​Plugin 설치

​설정

​구성

​음성

​메시지별 음성 재정의

​출력

​자동 선택 순서

​관련 문서

Plugin 설치

설정

구성

음성

메시지별 음성 재정의

출력

자동 선택 순서

관련 문서