GET
/v1/schemas/fal/audio/xai%2Fgrok-voice
Accept:
Request body
5 properties · 1 required · 5 $defs| property | type | description | constraints |
|---|---|---|---|
| audio_url* | string | URL 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 … | |
| voice | enum | Built-in xAI voice for the agent's reply. Uses Grok's default voice when omitted. | carina | zagan | helix | orion | luna | iris · +22 more · nullable |
| prompt | string | Optional system instructions describing the agent's persona and conversation context. Uses Grok's default persona when omitted. | length ≤ 20000 · nullable |
| tools | GrokToolsConfiguration | Server-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_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"xai/grok-voice","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}