# xAI (/en/ai/models/asr/xai)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

xAI provides real-time automatic speech recognition (ASR) over WebSocket for conversational AI applications.

<CalloutContainer type="info">
  <CalloutTitle>
    Info
  </CalloutTitle>

  <CalloutDescription>
    This integration is fully supported for use with Conversational AI Engine. While it has completed functional validation, it is newer to the platform, and additional provider-specific edge cases may be identified as usage scales across a broader range of applications and workloads.
  </CalloutDescription>
</CalloutContainer>

### Sample configuration [#sample-configuration]

The following example shows a starting `asr` parameter configuration you can use when you [Start a conversational AI agent](/en/api-reference/api-ref/conversational-ai/join).

```json
"asr": {
  "vendor": "xai",
  "params": {
    "api_key": "${env:XAI_API_KEY}",
    "base_url": "wss://api.x.ai/v1/stt",
    "sample_rate": 16000,
    "language": "en"
  }
}
```

<CalloutContainer type="warning">
  <CalloutTitle>
    Caution
  </CalloutTitle>

  <CalloutDescription>
    The parameters listed on this page are validated for use with Conversational AI Engine. Required parameters must be provided as documented. Any additional parameters are passed through directly to the underlying vendor without validation. For a full list of supported options, refer to the [xAI Speech to Text documentation](https://docs.x.ai/developers/model-capabilities/audio/speech-to-text#streaming-speech-to-text-websocket).
  </CalloutDescription>
</CalloutContainer>

### Key parameters [#key-parameters]

<ParameterList title="params" required="true">
  <Parameter name="api_key" type="string" required="true">
    The xAI API key used to authenticate requests. You must provide a valid key for the service to function.
  </Parameter>

  <Parameter name="base_url" type="string" required="false">
    The WebSocket endpoint URL for the xAI streaming STT API. Defaults to `wss://api.x.ai/v1/stt`.
  </Parameter>

  <Parameter name="sample_rate" type="integer" required="false">
    The audio sample rate in Hz. Supported values: `8000`, `16000`, `22050`, `24000`, `44100`, `48000`.
  </Parameter>

  <Parameter name="language" type="string" required="false">
    The language code to use for transcription. For example, use `en` for English. Setting this enables text formatting of numbers, currencies, and units. For supported language codes, refer to the [xAI documentation](https://docs.x.ai/developers/model-capabilities/audio/speech-to-text#supported-languages).
  </Parameter>
</ParameterList>