Providers

Gradium

Gradium, OpenClaw için bir metinden konuşmaya sağlayıcısıdır. Standart sesli yanıtlar (WAV), sesli notlarla uyumlu Opus çıktısı ve telefon arayüzleri için 8 kHz u-law ses üretir.

Özellik	Değer
Sağlayıcı kimliği	`gradium`
Kimlik doğrulama	`GRADIUM_API_KEY` veya `apiKey` yapılandırması
Temel URL	`https://api.gradium.ai` (varsayılan)
Varsayılan ses	`Emma` (`YTpq7expH9539ERJ`)

Plugin'i yükleme

Gradium, resmî bir harici Plugin'dir. Plugin'i yükleyin, ardından Gateway'i yeniden başlatın:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

Kurulum

Bir Gradium API anahtarı oluşturun, ardından bunu bir ortam değişkeni veya yapılandırma anahtarıyla kullanıma açın. Yapılandırma, ortam değişkenine göre önceliklidir.

Ortam değişkeni

bash

export GRADIUM_API_KEY="gsk_..."

Yapılandırma anahtarı

json5

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

Yapılandırma

json5

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

Anahtar	Tür	Açıklama
`tts.providers.gradium.apiKey`	dize	Çözümlenmiş API anahtarı. `${ENV}` ve gizli bilgi referanslarını destekler.
`tts.providers.gradium.baseUrl`	dize	`api.gradium.ai` üzerindeki HTTPS Gradium API URL'si. Sondaki eğik çizgiler kaldırılır. Varsayılan: `https://api.gradium.ai`.
`tts.providers.gradium.speakerVoiceId`	dize	Direktifle geçersiz kılma belirtilmediğinde kullanılan varsayılan ses kimliği.

Çıktı biçimi hedef arayüze göre otomatik olarak seçilir (bkz. Çıktı) ve openclaw.json içinde yapılandırılamaz.

Sesler

Ad	Ses kimliği
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (varsayılan)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

Mesaj başına sesi geçersiz kılma

Etkin konuşma ilkesi sesin geçersiz kılınmasına izin verdiğinde, bir direktif belirteciyle satır içinde sesler arasında geçiş yapın (bunların tümü eşdeğerdir ve sağlayıcıya özgü bir ses kimliği alır):

text

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

Konuşma ilkesi sesin geçersiz kılınmasını devre dışı bırakırsa direktif işlenir ancak yok sayılır.

Çıktı

Çıktı biçimi hedef arayüze göre seçilir; sağlayıcı başka biçimler üretmez.

Hedef	Biçim	Dosya uzantısı	Örnekleme hızı	Sesle uyumluluk işareti
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 şeklindedir. tts.provider sabitlenmediğinde OpenClaw'ın etkin sağlayıcıyı nasıl seçtiğini öğrenmek için Metinden Konuşmaya bölümüne bakın.

İlgili

Was this useful?