> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Speech

Azure Speech is een Azure AI Speech-provider voor tekst-naar-spraak. In OpenClaw
synthetiseert deze standaard uitgaande antwoordaudio als MP3, native Ogg/Opus
voor spraaknotities, en 8 kHz mulaw-audio voor telefoniekanalen zoals Voice Call.

OpenClaw gebruikt de Azure Speech REST API rechtstreeks met SSML en stuurt het
uitvoerformaat van de provider door via `X-Microsoft-OutputFormat`.

| Detail                               | Waarde                                                                                                            |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| Website                              | [Azure AI Speech](https://azure.microsoft.com/products/ai-services/ai-speech)                                     |
| Docs                                 | [Speech REST tekst-naar-spraak](https://learn.microsoft.com/azure/ai-services/speech-service/rest-text-to-speech) |
| Auth                                 | `AZURE_SPEECH_KEY` plus `AZURE_SPEECH_REGION`                                                                     |
| Standaardstem                        | `en-US-JennyNeural`                                                                                               |
| Standaardbestandsuitvoer             | `audio-24khz-48kbitrate-mono-mp3`                                                                                 |
| Standaardbestand voor spraaknotities | `ogg-24khz-16bit-mono-opus`                                                                                       |

## Aan de slag

<Steps>
  <Step title="Maak een Azure Speech-resource">
    Maak in de Azure-portal een Speech-resource. Kopieer **KEY 1** uit
    Resource Management > Keys and Endpoint, en kopieer de resourcelocatie
    zoals `eastus`.

    ```
    AZURE_SPEECH_KEY=<speech-resource-key>
    AZURE_SPEECH_REGION=eastus
    ```
  </Step>

  <Step title="Selecteer Azure Speech in messages.tts">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      messages: {
        tts: {
          auto: "always",
          provider: "azure-speech",
          providers: {
            "azure-speech": {
              speakerVoice: "en-US-JennyNeural",
              lang: "en-US",
            },
          },
        },
      },
    }
    ```
  </Step>

  <Step title="Stuur een bericht">
    Stuur een antwoord via een verbonden kanaal. OpenClaw synthetiseert de audio
    met Azure Speech en levert MP3 voor standaardaudio, of Ogg/Opus wanneer
    het kanaal een spraaknotitie verwacht.
  </Step>
</Steps>

## Configuratieopties

| Optie                   | Pad                                                         | Beschrijving                                                                                            |
| ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `apiKey`                | `messages.tts.providers.azure-speech.apiKey`                | Azure Speech-resourcesleutel. Valt terug op `AZURE_SPEECH_KEY`, `AZURE_SPEECH_API_KEY` of `SPEECH_KEY`. |
| `region`                | `messages.tts.providers.azure-speech.region`                | Azure Speech-resourceregio. Valt terug op `AZURE_SPEECH_REGION` of `SPEECH_REGION`.                     |
| `endpoint`              | `messages.tts.providers.azure-speech.endpoint`              | Optionele overschrijving voor Azure Speech-eindpunt/basis-URL.                                          |
| `baseUrl`               | `messages.tts.providers.azure-speech.baseUrl`               | Optionele overschrijving voor Azure Speech-basis-URL.                                                   |
| `speakerVoice`          | `messages.tts.providers.azure-speech.speakerVoice`          | Azure-stem ShortName (standaard `en-US-JennyNeural`). Verouderde alias: `voice`.                        |
| `lang`                  | `messages.tts.providers.azure-speech.lang`                  | SSML-taalcode (standaard `en-US`).                                                                      |
| `outputFormat`          | `messages.tts.providers.azure-speech.outputFormat`          | Uitvoerformaat voor audiobestanden (standaard `audio-24khz-48kbitrate-mono-mp3`).                       |
| `voiceNoteOutputFormat` | `messages.tts.providers.azure-speech.voiceNoteOutputFormat` | Uitvoerformaat voor spraaknotities (standaard `ogg-24khz-16bit-mono-opus`).                             |

## Opmerkingen

<AccordionGroup>
  <Accordion title="Authenticatie">
    Azure Speech gebruikt een Speech-resourcesleutel, geen Azure OpenAI-sleutel.
    De sleutel wordt verzonden als `Ocp-Apim-Subscription-Key`; OpenClaw leidt
    `https://<region>.tts.speech.microsoft.com` af uit `region`, tenzij je
    `endpoint` of `baseUrl` opgeeft.
  </Accordion>

  <Accordion title="Stemnamen">
    Gebruik de Azure Speech-stemwaarde `ShortName`, bijvoorbeeld
    `en-US-JennyNeural`. De gebundelde provider kan stemmen weergeven via
    dezelfde Speech-resource en filtert stemmen die als verouderd of buiten
    gebruik zijn gemarkeerd.
  </Accordion>

  <Accordion title="Audio-uitvoer">
    Azure accepteert uitvoerformaten zoals `audio-24khz-48kbitrate-mono-mp3`,
    `ogg-24khz-16bit-mono-opus` en `riff-24khz-16bit-mono-pcm`. OpenClaw
    vraagt Ogg/Opus aan voor `voice-note`-doelen, zodat kanalen native
    spraakballonnen kunnen verzenden zonder extra MP3-conversie.
  </Accordion>

  <Accordion title="Alias">
    `azure` wordt geaccepteerd als provideralias voor bestaande PR's en
    gebruikersconfiguratie, maar nieuwe configuratie moet `azure-speech`
    gebruiken om verwarring met Azure OpenAI-modelproviders te voorkomen.
  </Accordion>
</AccordionGroup>

## Gerelateerd

<CardGroup cols={2}>
  <Card title="Tekst-naar-spraak" href="/nl/tools/tts" icon="waveform-lines">
    TTS-overzicht, providers en `messages.tts`-configuratie.
  </Card>

  <Card title="Configuratie" href="/nl/gateway/configuration" icon="gear">
    Volledige configuratiereferentie inclusief `messages.tts`-instellingen.
  </Card>

  <Card title="Providers" href="/nl/providers" icon="grid">
    Alle gebundelde OpenClaw-providers.
  </Card>

  <Card title="Probleemoplossing" href="/nl/help/troubleshooting" icon="wrench">
    Veelvoorkomende problemen en foutopsporingsstappen.
  </Card>
</CardGroup>