GET
/v1/schemas/fal/audio/xai%2Fgrok-voice%2Frealtime
Accept:
Request body
5 properties · 1 required · 6 $defs| property | type | description | constraints |
|---|---|---|---|
| type* | string | xAI realtime event type (e.g. 'session.update', 'input_audio_buffer.append', 'response.create', 'response.output_audio.delta'). Events are relayed verbatim in both directions. | |
| prompt | string | System instructions describing the agent's persona and conversation context. Uses Grok's default persona when omitted. | length ≤ 20000 · nullable |
| turn_detection | GrokTurnDetectionConfiguration | xAI server-side voice activity detection (server_vad) tuning. | nullable |
| tools | GrokToolsConfiguration | Typed xAI tools supported by this app's convenience configuration. | nullable |
| voice | enum | Built-in xAI voice for the agent's speech. Uses Grok's default voice when omitted. | carina | zagan | helix | orion | luna | iris · +22 more · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"xai/grok-voice/realtime","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}