What you need
Getting your API key
- Sign in at console.x.ai.
- Open API Keys for your team.
- Create a key, name it, and copy the value.
xai-.
Adding the connection
- Go to Connections and choose Grok Realtime.
- Paste the API key.
- Save.
What you can select afterwards
Turn on Realtime in Model Configurations and choose Grok Realtime as the provider. Model and voice — pick from the dropdowns, or type a value if you want one that is not listed. xAI’s models page lists the current voice-agent models.How a speech-to-speech call differs
A speech-to-speech model replaces the transcriber and the voice provider. When a workflow is set to realtime, those two settings no longer apply.- The voice comes from the model. You cannot pair Grok Realtime with a voice from another provider.
- You still need a language model configured. It runs the work the realtime model does not — extracting variables and running QA analysis after the call. Without one, those features silently produce nothing.
- Context compaction does not apply and is ignored if enabled.
Troubleshooting
The connection saved fine but calls fail immediately
The connection saved fine but calls fail immediately
Saving does not check the key against xAI. Confirm the key is active in the console, that you copied it whole including the
xai- prefix, and that the team it belongs to has credits loaded.Requests are rejected even though the key is new
Requests are rejected even though the key is new
xAI needs credits on the account before it serves requests. Load credits on the team that owns the key.
Variables are not extracted and QA never runs
Variables are not extracted and QA never runs
Both need an LLM configured alongside the realtime provider. Check the LLM tab in Model Configurations.
The workflow still uses a separate voice and transcriber
The workflow still uses a separate voice and transcriber
The workflow is not set to realtime. Switch it over on Model Configurations, then pick Grok Realtime — the transcriber and voice settings stop applying at that point.