Providers

Azure Konuşma

Azure Speech, paketle birlikte sunulan bir Azure AI Speech metinden sese sağlayıcısıdır. OpenClaw, SSML kullanarak Azure Speech REST API'sini doğrudan çağırır; standart yanıtlar için MP3, sesli notlar için yerel Ogg/Opus ve Voice Call gibi telefon kanalları için 8 kHz mulaw sentezler. İstek, sağlayıcının sahip olduğu çıktı biçimini X-Microsoft-OutputFormat başlığı üzerinden gönderir.

Ayrıntı	Değer
Sağlayıcı kimliği	`azure-speech` (takma ad: `azure`)
Web sitesi	Azure AI Speech
Belgeler	Speech REST metinden sese
Kimlik doğrulama	`AZURE_SPEECH_KEY` ile `AZURE_SPEECH_REGION`
Varsayılan ses	`en-US-JennyNeural`
Varsayılan dosya çıktısı	`audio-24khz-48kbitrate-mono-mp3`
Varsayılan sesli not dosyası	`ogg-24khz-16bit-mono-opus`

Başlarken

Bir Azure Speech kaynağı oluşturun

Azure portalında bir Speech kaynağı oluşturun. Resource Management > Keys and Endpoint bölümündeki KEY 1 değerini ve eastus gibi kaynak konumunu kopyalayın.

Code

AZURE_SPEECH_KEY=<speech-resource-key>AZURE_SPEECH_REGION=eastus

messages.tts içinde Azure Speech'i seçin

json5

{  messages: {    tts: {      auto: "always",      provider: "azure-speech",      providers: {        "azure-speech": {          voice: "en-US-JennyNeural",          lang: "en-US",        },      },    },  },}

Bir mesaj gönderin

Bağlı herhangi bir kanal üzerinden yanıt gönderin. OpenClaw, sesi Azure Speech ile sentezler ve standart ses için MP3, kanal bir sesli not beklediğinde ise Ogg/Opus olarak iletir.

Yapılandırma seçenekleri

Tüm seçenekler messages.tts.providers["azure-speech"] altında bulunur.

Seçenek	Açıklama
`apiKey`	Azure Speech kaynak anahtarı. Ayarlanmazsa `AZURE_SPEECH_KEY`, `AZURE_SPEECH_API_KEY` veya `SPEECH_KEY` kullanılır.
`region`	Azure Speech kaynak bölgesi. Ayarlanmazsa `AZURE_SPEECH_REGION` veya `SPEECH_REGION` kullanılır.
`endpoint`	İsteğe bağlı Azure Speech uç noktası geçersiz kılma değeri. Ayarlanmazsa `AZURE_SPEECH_ENDPOINT` kullanılır.
`baseUrl`	İsteğe bağlı Azure Speech temel URL'si geçersiz kılma değeri.
`voice`	Azure sesinin ShortName değeri (varsayılan: `en-US-JennyNeural`). Eski takma ad: `voiceId`.
`lang`	SSML dil kodu (varsayılan: `en-US`).
`outputFormat`	Ses dosyası çıktı biçimi (varsayılan: `audio-24khz-48kbitrate-mono-mp3`).
`voiceNoteOutputFormat`	Sesli not çıktı biçimi (varsayılan: `ogg-24khz-16bit-mono-opus`).
`timeoutMs`	Milisaniye cinsinden istek zaman aşımı geçersiz kılma değeri. Ayarlanmazsa genel `messages.tts.timeoutMs` kullanılır.

apiKey ile birlikte region, endpoint veya baseUrl seçeneklerinden biri ayarlandığında sağlayıcı yapılandırılmış kabul edilir. Ortam değişkenleri yalnızca ayarlanmamış yapılandırma anahtarları için yedek olarak denetlenir.

Notlar

Kimlik doğrulama

Azure Speech, Azure OpenAI anahtarı değil, bir Speech kaynak anahtarı kullanır. Anahtar Ocp-Apim-Subscription-Key olarak gönderilir; endpoint veya baseUrl sağlamadığınız sürece OpenClaw, region değerinden https://<region>.tts.speech.microsoft.com adresini türetir.

Ses adları

Azure Speech sesinin ShortName değerini kullanın; örneğin en-US-JennyNeural. Paketle birlikte sunulan sağlayıcı, aynı Speech kaynağı üzerinden sesleri listeleyebilir ve kullanımdan kaldırılmış, hizmetten çekilmiş veya devre dışı olarak işaretlenen sesleri filtreler.

Ses çıktıları

Azure; audio-24khz-48kbitrate-mono-mp3, ogg-24khz-16bit-mono-opus ve riff-24khz-16bit-mono-pcm gibi çıktı biçimlerini kabul eder. OpenClaw, kanalların ek bir MP3 dönüştürmesi olmadan yerel ses baloncukları gönderebilmesi için voice-note hedeflerinde Ogg/Opus ister ve telefon hedeflerinde raw-8khz-8bit-mono-mulaw biçimini zorunlu kılar.

Takma ad

Mevcut yapılandırmalar için azure sağlayıcı takma adı kabul edilir ancak Azure OpenAI model sağlayıcılarıyla karışıklığı önlemek amacıyla yeni yapılandırmalarda azure-speech kullanılmalıdır.