Skip to main content
POST
Synthesize speech

Authorizations

Authorization
string
header
required

Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).

Body

application/json
model
enum<string>
required

Must be grok-tts.

Available options:
grok-tts
input
string
required

Text to synthesize — max 4,096 Unicode code points.

Maximum string length: 4096
voice
string
required

Built-in voice ID (from GET /v1/voices) or your organization's custom voice ID (from GET /v1/custom-voices).

language
string

BCP-47 language hint (e.g. en, en-US, es). Defaults to the voice's primary language when omitted.

response_format
enum<string>

Output format. Only mp3 is accepted in this release.

Available options:
mp3

Response

Raw MP3 audio stream.

The response is of type file.