Grok Text to Speech is the Grok voice family’s text-to-audio capability. The manufacturer documents expressive built-in speakers, inline vocal cues and output formats suited to media playback or telephone audio. Its input is the transcript to be spoken, together with voice and language choices. The resulting recording is speech from that transcript; speech recognition and conversational speech-to-speech models have separate tasks.
The producer catalogue gives each voice a delivery profile. Ara is warm and friendly, Eve is upbeat with a British accent, and Rex is described as clear and confident. Voice and language are independent in the documented family: built-in speakers can use each supported language choice. The guide lists twenty language-code options, including regional variants, and also supports automatic language detection. Alongside built-in speakers, the producer documents reusable custom voices created from a reference recording and selected by voice_id for complete or streaming synthesis. Reference audio may be up to 120 seconds; 90–120 seconds of clean, single-speaker speech is recommended to capture delivery and intonation. Keep the reference, created voice profile and generated recording as separate artifacts, and match the reference performance to the intended script.
Prepare the final spoken wording, preserving the intended language of names and quoted passages. For a narrated guide, a useful line is: “Choose a topic, listen to the short introduction, and open the section you want to explore.” If a brand name or specialist term needs a particular reading, the manufacturer’s replacement controls can supply a respelling or IPA pronunciation without changing the displayed source text. A separate text-normalisation option converts written numbers, abbreviations and symbols towards their spoken form.
Inline tags place an event at a particular point, such as a pause, laugh, sigh or breath. Wrapping tags apply delivery to a complete phrase, for example whispering, emphasis or a slower passage. Put the cue where the meaning calls for it and keep the words readable. The guide recommends complete-phrase style spans and punctuation rather than a stack of unrelated tags.
For an expressive character line, prepare the spoken sentence and the performance shift together. For an explanation, retain a clear rhythm that helps the listener follow the steps. The documented speech-rate range is 0.7 to 1.5, with 1.0 as normal delivery. A speed choice changes the spoken pace; it does not change the words the application should communicate.
The producer documents MP3, WAV, raw PCM, mu-law and A-law output. Supported sample-rate choices span 8 kHz to 48 kHz, with specific listed rates between those values. Its default MP3 configuration is 24 kHz at 128 kbit/s. Use an audio representation that the intended player, editing stage or telephone path can interpret.
Optional character timings associate the returned character sequence with start and end times. Without pronunciation replacements, that sequence mirrors the input; replacements can change it to the spoken text. They can support a read-along display, highlighting or alignment with a visual performance. In the complete-response workflow, requesting timings changes the output into an envelope containing encoded audio and timing data. Treat the timings and audio as a paired result, especially when text normalisation expands a written symbol into several spoken words.
The manufacturer offers a complete-request path and bidirectional streaming, in which text fragments arrive and audio chunks return as the utterance is generated. It documents a 60,000-character limit for a complete request and for an individual streamed text fragment. Completing or clearing an utterance has an explicit role in the streaming workflow.
For longer narration, choose coherent passage boundaries and retain the script with each result. For interactive playback, distinguish text sent for synthesis from audio already heard by the listener. The useful deliverable is a voiced script with intentional performance cues, an appropriate audio format and timing data when the application needs it. Keep the script, selected voice, performance cues and output settings with the audio so later revisions preserve the intended delivery.
", "aboutText": "Grok Text to Speech is the Grok voice family’s text-to-audio capability. The manufacturer documents expressive built-in speakers, inline vocal cues and output formats suited to media playback or telephone audio. Its input is the transcript to be spoken, together with voice and language choices. The resulting recording is speech from that transcript; speech recognition and conversational speech-to-speech models have separate tasks.\n\n### Voice, language and spoken text\n\nThe producer catalogue gives each voice a delivery profile. Ara is warm and friendly, Eve is upbeat with a British accent, and Rex is described as clear and confident. Voice and language are independent in the documented family: built-in speakers can use each supported language choice. The guide lists twenty language-code options, including regional variants, and also supports automatic language detection. Alongside built-in speakers, the producer documents reusable custom voices created from a reference recording and selected by voice_id for complete or streaming synthesis. Reference audio may be up to 120 seconds; 90–120 seconds of clean, single-speaker speech is recommended to capture delivery and intonation. Keep the reference, created voice profile and generated recording as separate artifacts, and match the reference performance to the intended script.\n\nPrepare the final spoken wording, preserving the intended language of names and quoted passages. For a narrated guide, a useful line is: “Choose a topic, listen to the short introduction, and open the section you want to explore.” If a brand name or specialist term needs a particular reading, the manufacturer’s replacement controls can supply a respelling or IPA pronunciation without changing the displayed source text. A separate text-normalisation option converts written numbers, abbreviations and symbols towards their spoken form.\n\n### Performance cues\n\nInline tags place an event at a particular point, such as a pause, laugh, sigh or breath. Wrapping tags apply delivery to a complete phrase, for example whispering, emphasis or a slower passage. Put the cue where the meaning calls for it and keep the words readable. The guide recommends complete-phrase style spans and punctuation rather than a stack of unrelated tags.\n\nFor an expressive character line, prepare the spoken sentence and the performance shift together. For an explanation, retain a clear rhythm that helps the listener follow the steps. The documented speech-rate range is 0.7 to 1.5, with 1.0 as normal delivery. A speed choice changes the spoken pace; it does not change the words the application should communicate.\n\n### Audio and timings\n\nThe producer documents MP3, WAV, raw PCM, mu-law and A-law output. Supported sample-rate choices span 8 kHz to 48 kHz, with specific listed rates between those values. Its default MP3 configuration is 24 kHz at 128 kbit/s. Use an audio representation that the intended player, editing stage or telephone path can interpret.\n\nOptional character timings associate the returned character sequence with start and end times. Without pronunciation replacements, that sequence mirrors the input; replacements can change it to the spoken text. They can support a read-along display, highlighting or alignment with a visual performance. In the complete-response workflow, requesting timings changes the output into an envelope containing encoded audio and timing data. Treat the timings and audio as a paired result, especially when text normalisation expands a written symbol into several spoken words.\n\n### Complete or streaming generation\n\nThe manufacturer offers a complete-request path and bidirectional streaming, in which text fragments arrive and audio chunks return as the utterance is generated. It documents a 60,000-character limit for a complete request and for an individual streamed text fragment. Completing or clearing an utterance has an explicit role in the streaming workflow.\n\nFor longer narration, choose coherent passage boundaries and retain the script with each result. For interactive playback, distinguish text sent for synthesis from audio already heard by the listener. The useful deliverable is a voiced script with intentional performance cues, an appropriate audio format and timing data when the application needs it. Keep the script, selected voice, performance cues and output settings with the audio so later revisions preserve the intended delivery.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "0804703fe7eaac520274ffc360a2dd47fef90bf665749f938a7dd2980db3adb9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "en", "methods": [ { "html": "x-ai/grok-voice-tts-1.0Grok Text to Speech turns written text into expressive audio with selectable voices, inline performance cues and multiple output codecs. The documented producer family supports complete and streaming speech, plus optional character-level timings.
This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.
Grok Text to Speech is the Grok voice family’s text-to-audio capability. The manufacturer documents expressive built-in speakers, inline vocal cues and output formats suited to media playback or telephone audio. Its input is the transcript to be spoken, together with voice and language choices. The resulting recording is speech from that transcript; speech recognition and conversational speech-to-speech models have separate tasks.
The producer catalogue gives each voice a delivery profile. Ara is warm and friendly, Eve is upbeat with a British accent, and Rex is described as clear and confident. Voice and language are independent in the documented family: built-in speakers can use each supported language choice. The guide lists twenty language-code options, including regional variants, and also supports automatic language detection. Alongside built-in speakers, the producer documents reusable custom voices created from a reference recording and selected by voice_id for complete or streaming synthesis. Reference audio may be up to 120 seconds; 90–120 seconds of clean, single-speaker speech is recommended to capture delivery and intonation. Keep the reference, created voice profile and generated recording as separate artifacts, and match the reference performance to the intended script.
Prepare the final spoken wording, preserving the intended language of names and quoted passages. For a narrated guide, a useful line is: “Choose a topic, listen to the short introduction, and open the section you want to explore.” If a brand name or specialist term needs a particular reading, the manufacturer’s replacement controls can supply a respelling or IPA pronunciation without changing the displayed source text. A separate text-normalisation option converts written numbers, abbreviations and symbols towards their spoken form.
Inline tags place an event at a particular point, such as a pause, laugh, sigh or breath. Wrapping tags apply delivery to a complete phrase, for example whispering, emphasis or a slower passage. Put the cue where the meaning calls for it and keep the words readable. The guide recommends complete-phrase style spans and punctuation rather than a stack of unrelated tags.
For an expressive character line, prepare the spoken sentence and the performance shift together. For an explanation, retain a clear rhythm that helps the listener follow the steps. The documented speech-rate range is 0.7 to 1.5, with 1.0 as normal delivery. A speed choice changes the spoken pace; it does not change the words the application should communicate.
The producer documents MP3, WAV, raw PCM, mu-law and A-law output. Supported sample-rate choices span 8 kHz to 48 kHz, with specific listed rates between those values. Its default MP3 configuration is 24 kHz at 128 kbit/s. Use an audio representation that the intended player, editing stage or telephone path can interpret.
Optional character timings associate the returned character sequence with start and end times. Without pronunciation replacements, that sequence mirrors the input; replacements can change it to the spoken text. They can support a read-along display, highlighting or alignment with a visual performance. In the complete-response workflow, requesting timings changes the output into an envelope containing encoded audio and timing data. Treat the timings and audio as a paired result, especially when text normalisation expands a written symbol into several spoken words.
The manufacturer offers a complete-request path and bidirectional streaming, in which text fragments arrive and audio chunks return as the utterance is generated. It documents a 60,000-character limit for a complete request and for an individual streamed text fragment. Completing or clearing an utterance has an explicit role in the streaming workflow.
For longer narration, choose coherent passage boundaries and retain the script with each result. For interactive playback, distinguish text sent for synthesis from audio already heard by the listener. The useful deliverable is a voiced script with intentional performance cues, an appropriate audio format and timing data when the application needs it. Keep the script, selected voice, performance cues and output settings with the audio so later revisions preserve the intended delivery.
POST /v1/audio/speechtextaudio| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits x-ai/grok-voice-tts-1.0 | Default— |
Fieldinput | Typestring | RequirementRequired | Values & limits Minimum length: 1 Maximum length: 15,000 Unit: Unicode characters | Default— |
Fieldvoice | Typestring | RequirementRequired | Values & limits eve, ara, rex, sal, leo | Default— |
Fieldresponse_format | Typestring | RequirementRequired | Values & limits mp3 | Default— |
text_to_speech · Required: input
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input, voice, response_format |
Parametervoice_ids | Contracteve, ara, rex, sal, leo |
Parameterresponse_format | Contractmp3 |
Parametermax_input_characters | Contract15000 |
Parameterother_options | Contractfalse |
Parameterinput | Contractexact UTF-8 text; Unicode character count without normalization |
Parametermaterial_types | Contracttext |
Lifecycle: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · actual returned task_id or media library record
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Select exact voice from this model profile.
Input characters and audio seconds are different meters.
Tariff references do not add request options. Supported parameters are listed for the selected method.
Match each charge to the conditions shown. Use one rate for each set of alternative configurations.
| Configuration | Rate schedule | Billable quantity | Billing unit | Charge |
|---|---|---|---|---|
| ConfigurationBase token rates | Rate scheduleBase rate | Billable quantity— | Billing unit— | Charge Input · Input tokens — / 1K tokens Output · Output tokens — / 1K tokens Input · Cache read — / 1K tokens Input · Cache write — / 1K tokens Input · Cache write, 1 hour — / 1K tokens |
| ConfigurationUltra | Rate schedule— | Billable quantityEach Unicode code point counts as one character, including Han characters. | Billing unitper 1000 input character | Charge Input · input character $0.03 per 1000 input character |
Model-level reference schedules do not change method selection, quotes or charges. Active charges use the selected Ailoot method rates.
| Configuration | Billing conditions | Charge |
|---|---|---|
| ConfigurationSpaceXAI: Grok Voice TTS 1.0 · Default configuration | Billing conditionsDefault configuration | Charge Input · Input characters $0.00003 per input character |
Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"\nexport AILOOT_VOICE_ID\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "x-ai/grok-voice-tts-1.0", "input": "Good afternoon! This is a short voice take."}')\nvoice=os.environ["AILOOT_VOICE_ID"]\nallowed=json.loads('["eve", "ara", "rex", "sal", "leo"]')\nif voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")\np["voice"]=voice\np["response_format"]="mp3"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o speech.mp3\nmp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"\nexport AILOOT_MEDIA_TASK_ID\nresource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path("media-task.json").read_text())))\nPY_RESULT\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"\nexport AILOOT_ASSET_ID\nresource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nprint(json.dumps(json.loads(Path("media-asset.json").read_text())))\nPY_RESULT\nKeep every complete returned response, file and content part.
Keep the complete binary result and headers. If JSON/multiple outputs are returned, retain every data item and fetch each actual signed asset URL.
Retain original operation_id/X-Client-Request-ID for reconciliation without resubmission; no dedicated audio poll route.
| Field | Type |
|---|---|
Fieldbinary audio | Typebytes |
Fieldresponse headers | Typeheaders |
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionInvalid required fields, material representation or parameter value | Next stepCorrect the indicated fields before a new creation request. |
Responseserver_error | ConditionThe returned response says the operation or result requires a check | Next stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request. |
Ailoot Ultra x-ai/grok-voice-tts-1.0
Use the method paths shown above.