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

# Xai

> Python API reference for the xai realtime models plugin.

<Card title="Usage guide" icon="book" href="/plugins/realtime/xai" horizontal>
  Setup, environment variables, and Python/JavaScript/Go usage examples.
</Card>

## XaiRealtime

Realtime speech-to-speech integration for the xAI Grok Realtime API.

Wraps an xAI Grok realtime model so it can be used as a full
speech-to-speech provider within the runtime. Configuration is supplied
through an `XaiRealtimeConfig` instance and resolved into a flat
parameter map for the runtime.

### Constructor

```python theme={null}
XaiRealtime(*, api_key: 'str | None' = None, config: 'XaiRealtimeConfig | None' = None, **kwargs)
```

<ParamField path="api_key" type="str | None">
  xAI API key. When omitted, the value of the `XAI_API_KEY` environment variable is used.
</ParamField>

<ParamField path="config" type="XaiRealtimeConfig | None">
  Provider configuration. When omitted, a default `XaiRealtimeConfig` is used.
</ParamField>

### aclose

```python theme={null}
def aclose(self) -> 'None'
```

Release any resources held by the integration.

This implementation performs no work and exists so the integration
can be used interchangeably with providers that require teardown.

### cleanup

```python theme={null}
def cleanup(self) -> 'None'
```

Clean up the integration by delegating to `aclose`.

***

## XaiRealtimeConfig

### Fields

<ParamField path="model" type="str" default="grok-realtime" />

<ParamField path="voice" type="str" default="Ara" />

<ParamField path="modalities" type="List[str]" default="…" />

<ParamField path="temperature" type="float" default="0.8" />

<ParamField path="max_response_output_tokens" type="Union[int, str]" default="inf" />

<ParamField path="turn_detection" type="Optional[TurnDetectionConfig]" default="…" />

<ParamField path="input_audio_transcription" type="Optional[InputAudioTranscriptionConfig]" default="…" />

<ParamField path="tool_choice" type="str" default="auto" />

<ParamField path="base_url" type="Optional[str]" />

***

## TurnDetectionConfig

### Fields

<ParamField path="type" type="str" default="server_vad" />

<ParamField path="threshold" type="float" default="0.5" />

<ParamField path="prefix_padding_ms" type="int" default="300" />

<ParamField path="silence_duration_ms" type="int" default="200" />

<ParamField path="create_response" type="bool" default="True" />

<ParamField path="interrupt_response" type="bool" default="True" />

***

## InputAudioTranscriptionConfig

### Fields

<ParamField path="model" type="str" default="gpt-4o-mini-transcribe" />