Grok (xAI)
Set up Grok as a speech-to-text provider for real-time meeting bot transcription.
Use Grok (xAI) as the speech-to-text provider for real-time transcription with meeting bots. Recall sends meeting audio to Grok and delivers normalized transcript events to your application.
Supported transcription workflows
| Workflow | Supported |
|---|---|
| Real-time transcription with meeting bots | Yes — grok_streaming |
| Post-meeting transcription | No |
| Real-time transcription with Desktop Recording SDK | No |
You can download the transcript generated live after the meeting ends. This is different from creating a new post-meeting transcription job: Grok is not currently available through Create Async Transcript.
Setup
- Sign in to the xAI Console, select the team you want to use, and click Create API key. Enter a descriptive name, create the key, and copy it. Make sure the team has API credits and access to speech-to-text transcription.
- Open the Recall.ai dashboard in the region where you create your bots, go to Transcription → Grok, and add your xAI API key. For example, the us-west-2 Grok settings are for bots created in us-west-2.
Recall.ai regions are isolated. Add the key in each region where you create bots: us-east-1, us-west-2, eu-central-1, or ap-northeast-1. - Select
grok_streamingin each bot's transcription configuration, as shown below.
Adding your API key saves the credentials for the integration. It does not automatically enable Grok transcription for your bots. Configure both the provider and a real-time endpoint in your Create Bot request.
Quickstart: real-time transcription with meeting bots
Call Create Bot with recording_config.transcript.provider.grok_streaming and an endpoint subscribed to transcript.data:
curl --request POST \
--url https://RECALL_REGION.recall.ai/api/v1/bot/ \
--header 'Authorization: RECALL_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"meeting_url": "MEETING_URL",
"recording_config": {
"transcript": {
"provider": {
"grok_streaming": {
"interim_results": true
}
}
},
"realtime_endpoints": [
{
"type": "webhook",
"url": "REAL_TIME_TRANSCRIPT_WEBHOOK_ENDPOINT",
"events": ["transcript.data", "transcript.partial_data"]
}
]
}
}'Replace RECALL_REGION, RECALL_API_KEY, MEETING_URL, and the endpoint URL with your values. Use a valid meeting URL. The Authorization header contains your Recall.ai API key; your xAI API key is configured separately in the dashboard.
For WebSocket delivery, use an endpoint with "type": "websocket" and a wss:// URL instead. See Real-Time Websocket Endpoints.
Receive finalized and partial transcripts
transcript.datadelivers finalized utterances.transcript.partial_datadelivers interim updates. Enableinterim_resultsin the Grok provider configuration and subscribe to this event to receive them. Partial text may change; replace it with the finalized utterance when it arrives.
Saving a provider key alone does not send events. Your application must have a reachable real-time endpoint configured in recording_config.realtime_endpoints. Verify incoming requests using your workspace verification secret before processing them.
Follow the meeting bot real-time transcription guide for request verification, handling transcript failures, and retrieving the full transcript after the meeting. See Real-Time Event Payloads for event schemas.
Provider configuration
Set Grok options inside recording_config.transcript.provider.grok_streaming. The current Create Bot API reference defines the available fields, types, and defaults. Common options include:
| Option | Type | Purpose |
|---|---|---|
model | string | xAI transcription model; defaults to grok-voice-transcribe-2.0. |
language | string | Optional language code. Grok detects spoken languages automatically; a hint can help when speech is ambiguous. See supported languages. |
interim_results | boolean | Enables interim results; defaults to true. |
endpointing | integer | Silence duration in milliseconds before an utterance is finalized; defaults to 400, range 0–5000. |
keyterm | array of strings | Terms to bias transcription toward; up to 100 terms, each at most 50 characters. |
For example, to add keyterms:
{
"grok_streaming": {
"interim_results": true,
"keyterm": ["Recall.ai", "Grok"]
}
}keyterm is an array, even when you provide only one term.
For speaker identification options and configuration, see Diarization.
Updated 16 days ago
