GET

/v1/schemas/fal/audio/xai%2Fgrok-voice

kind inputactivity audiohash 27628155…extracted Nov 10, 2026version currentsource upstream spec ↗

Request body

5 properties · 1 required · 5 $defs
propertytypedescriptionconstraints
audio_url*stringURL of the audio containing the user's speech. The Grok agent listens to it and replies with speech. Most common audio formats are supported; the audio is converted to 16-bit 24 kHz mono PCM before being sent to Grok. Maximum duration 10 minutes, maximum file …
voiceenumBuilt-in xAI voice for the agent's reply. Uses Grok's default voice when omitted.carina | zagan | helix | orion | luna | iris · +22 more · nullable
promptstringOptional system instructions describing the agent's persona and conversation context. Uses Grok's default persona when omitted.length ≤ 20000 · nullable
toolsGrokToolsConfigurationServer-side tools available to the agent. Web, X, and remote MCP tools are supported; every tool is disabled by default. file_search/collections are unsupported by the typed configuration due to ZDR.
enable_safety_checkerbooleanAuthorized callers may set false to request relaxed screening.default: true

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"xai/grok-voice","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}