Azure Konuşma Hizmeti

Azure Speech, paketle birlikte sunulan bir Azure AI Speech metinden sese sağlayıcısıdır. OpenClaw, Azure Speech REST API’sini SSML ile doğrudan çağırarak standart yanıtlar için MP3, sesli notlar için yerel Ogg/Opus ve Sesli Arama gibi telefon kanalları için 8 kHz mulaw sentezler. İstek, sağlayıcının belirlediği çıktı biçimini X-Microsoft-OutputFormat üst bilgisi aracılığıyla gönderir.

Ayrıntı	Değer
Sağlayıcı kimliği	`azure-speech` (diğer ad: `azure`)
Web sitesi	Azure AI Speech
Belgeler	Speech REST metinden sese
Kimlik doğrulama	`AZURE_SPEECH_KEY` ve `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ünden KEY 1 değerini ve eastus gibi kaynak konumunu kopyalayın.

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

tts içinde Azure Speech'i seçin

{
  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 ya da kanal bir sesli not beklediğinde Ogg/Opus olarak iletir.

Yapılandırma seçenekleri

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

Seçenek	Açıklama
`apiKey`	Azure Speech kaynak anahtarı. `AZURE_SPEECH_KEY`, `AZURE_SPEECH_API_KEY` veya `SPEECH_KEY` değerine geri döner.
`region`	Azure Speech kaynak bölgesi. `AZURE_SPEECH_REGION` veya `SPEECH_REGION` değerine geri döner.
`endpoint`	İsteğe bağlı Azure Speech uç noktası geçersiz kılma değeri. Güvenilir `AZURE_SPEECH_ENDPOINT` değerine geri döner.
`baseUrl`	İsteğe bağlı Azure Speech temel URL geçersiz kılma değeri.
`voice`	Azure ses ShortName değeri (varsayılan `en-US-JennyNeural`). Eski diğer 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. Genel `tts.timeoutMs` değerine geri döner.

apiKey ile birlikte region, endpoint veya baseUrl değerlerinden biri ayarlandığında sağlayıcı yapılandırılmış kabul edilir. Ortam değişkenleri yalnızca ayarlanmamış bırakılan yapılandırma anahtarları için geri dönüş olarak denetlenir. Çalışma alanı .env dosyaları AZURE_SPEECH_ENDPOINT değerini ayarlayamaz; uç nokta yönlendirmesi için işlem ortamını, genel çalışma zamanı dotenv’ini veya açık yapılandırmayı kullanın.

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; OpenClaw, endpoint veya baseUrl sağlamadığınız sürece https://<region>.tts.speech.microsoft.com değerini region değerinden 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ış, sonlandırılmış 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 MP3 dönüştürmesi olmadan yerel ses balonları gönderebilmesi için voice-note hedeflerinde Ogg/Opus ister ve telefon hedefleri için raw-8khz-8bit-mono-mulaw biçimini zorunlu kılar.

Diğer ad

azure, mevcut yapılandırma için sağlayıcı diğer adı olarak kabul edilir ancak Azure OpenAI model sağlayıcılarıyla karışıklığı önlemek için yeni yapılandırmada azure-speech kullanılmalıdır.

İlgili

Metinden sese

TTS genel bakışı, sağlayıcılar ve tts yapılandırması.

Yapılandırma

tts ayarlarını da içeren tam yapılandırma başvurusu.

Sağlayıcılar

Paketle birlikte sunulan tüm OpenClaw sağlayıcıları.

Sorun giderme

Yaygın sorunlar ve hata ayıklama adımları.

Overview

Concepts and configuration

Providers

Azure Konuşma Hizmeti

Başlarken

Yapılandırma seçenekleri

Notlar

İlgili

Metinden sese

Yapılandırma

Sağlayıcılar

Sorun giderme

​Başlarken

​Yapılandırma seçenekleri

​Notlar

​İlgili

Metinden sese

Yapılandırma

Sağlayıcılar

Sorun giderme

Başlarken

Yapılandırma seçenekleri

Notlar

İlgili