{"servers":[{"url":"https://api.modellix.ai/api/v1/xai/grok-voice-tts"}],"post":{"description":"[Core Function] Grok Voice TTS converts text into natural spoken audio with expressive voices and optional speech tags embedded in the text. [Strengths] Supports 20+ languages (plus auto-detect), 26 built-in voices, multiple codecs (mp3/wav/pcm/mulaw/alaw), and custom voice IDs. [Best For] Product voiceovers, IVR/telephony (mulaw/alaw), and multilingual narration. [Limitations] Do NOT exceed 15,000 characters per request. Audio is returned on the completed task after polling. [Routing] Use this model for xAI Grok Voice quality or custom cloned voices. [Built-in voices] Original: eve (default), ara, leo, rex, sal. Flagship: altair, atlas, carina, castor, celeste, cosmo, helios, helix, iris, kepler, lumen, luna, lux, naksh, orion, perseus, rigel, sirius, ursa, zagan, zenith — case-insensitive; custom voice IDs are also accepted as voice_id.","operationId":"grokVoiceTTS","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Minimal request (default voice eve)","value":{"language":"en","text":"Hello! Welcome to the xAI Text to Speech API."}},"builtin_voice_ara":{"summary":"Built-in voice ara","value":{"language":"en","text":"Hello from Ara.","voice_id":"ara"}},"full_options":{"summary":"Full options","value":{"bit_rate":192000,"codec":"mp3","language":"en","optimize_streaming_latency":0,"sample_rate":44100,"speed":1.2,"text":"Crystal clear audio at maximum quality.","text_normalization":true,"voice_id":"rex"}}},"schema":{"additionalProperties":false,"properties":{"bit_rate":{"default":128000,"description":"MP3 bit rate in bps. Only applied when codec is mp3. Default 128000.","enum":[32000,64000,96000,128000,192000],"type":"integer"},"codec":{"default":"mp3","description":"Audio codec. Default mp3.","enum":["mp3","wav","pcm","mulaw","alaw"],"type":"string"},"language":{"description":"BCP-47 language code, or auto for automatic detection.","enum":["auto","en","ar-EG","ar-SA","ar-AE","bn","zh","fr","de","hi","id","it","ja","ko","pt-BR","pt-PT","ru","es-MX","es-ES","tr","vi"],"type":"string"},"optimize_streaming_latency":{"default":0,"description":"Latency vs quality trade-off: 0 best quality (default), 1 lower first-byte latency, 2 lowest first-byte latency.","enum":[0,1,2],"type":"integer"},"sample_rate":{"default":24000,"description":"Sample rate in Hz. Default 24000.","enum":[8000,16000,22050,24000,44100,48000],"type":"integer"},"speed":{"default":1,"description":"Speech speed multiplier. Range 0.7–1.5. Default 1.0.","maximum":1.5,"minimum":0.7,"type":"number"},"text":{"description":"Text to synthesize (max 15,000 characters). Supports inline speech tags such as [pause], [laugh], and wrapping tags like <whisper>...</whisper>.","maxLength":15000,"minLength":1,"type":"string"},"text_normalization":{"default":false,"description":"When true, normalize written-form text (numbers, abbreviations) before synthesis.","type":"boolean"},"voice_id":{"anyOf":[{"description":"Built-in voices (26). Default: eve.","enum":["eve","ara","leo","rex","sal","altair","atlas","carina","castor","celeste","cosmo","helios","helix","iris","kepler","lumen","luna","lux","naksh","orion","perseus","rigel","sirius","ursa","zagan","zenith"],"type":"string"},{"description":"Custom voice ID from your xAI voice library.","minLength":1,"type":"string"}],"default":"eve","description":"Voice ID for synthesis. Built-in voices are listed below (26 total, case-insensitive). Custom voice IDs from your xAI voice library are also accepted."}},"required":["text","language"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"code":0,"data":{"get_result":{"method":"GET","url":"https://api.modellix.ai/api/v1/tasks/task-grok-voice-tts-001"},"model_id":"xai/grok-voice-tts","status":"pending","task_id":"task-grok-voice-tts-001"},"message":"success"},"schema":{"description":"Response object for asynchronous task submission.","properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Task submission details. Poll GET /api/v1/tasks/{task_id} until status is success; audio appears in result.resources.","properties":{"get_result":{"description":"Endpoint to query the task result. See Common API: Query Task Result.","properties":{"method":{"example":"GET","type":"string"},"url":{"example":"https://api.modellix.ai/api/v1/tasks/task-grok-voice-tts-001","type":"string"}},"type":"object"},"model_id":{"description":"Model ID in provider/model format","example":"xai/grok-voice-tts","type":"string"},"status":{"description":"Initial task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier for polling","example":"task-grok-voice-tts-001","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully. Poll GET /api/v1/tasks/{task_id} until the task completes; synthesized audio is returned on the task result."},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limited"},"500":{"description":"Internal server error"}},"summary":"Grok Voice TTS","x-mint":{"href":"xai/grok-voice-tts"}}}