> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok TTS

> Up to 4,096 characters per request · mp3 output.

**Text-to-speech** · xAI

## Call it

Endpoint: `POST /v1/audio/speech` — set `model` to `grok-tts`.

```bash cURL theme={"dark"}
curl https://api.aireserve.com/v1/audio/speech \
  -H "Authorization: Bearer $AIRESERVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-tts", "input": "Welcome to AI Reserve.", "voice": "ara"}' \
  --output speech.mp3
```

```python Python theme={"dark"}
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.aireserve.com/v1",
    api_key=os.environ["AIRESERVE_API_KEY"],
)

with client.audio.speech.with_streaming_response.create(
    model="grok-tts",
    voice="ara",
    input="Welcome to AI Reserve.",
) as response:
    response.stream_to_file("speech.mp3")
```

```typescript TypeScript theme={"dark"}
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.aireserve.com/v1",
  apiKey: process.env.AIRESERVE_API_KEY,
});

const res = await client.audio.speech.create({
  model: "grok-tts",
  voice: "ara",
  input: "Welcome to AI Reserve.",
});
await Bun.write("speech.mp3", await res.arrayBuffer());
```

Full request and response reference: [Text-to-speech guide](/capabilities/text-to-speech).

## IDs & aliases

| Send as `model` | What it is |
| - | - |
| `grok-tts` | Canonical gateway id |

## Specs

| Spec | Detail |
| - | - |
| Modality | Audio & voice — Text-to-speech |
| Model maker | xAI |
| Served by | xAI |
| Pricing | billed per input character — see guide |
| Hosting | United States |

Prices are public list rates at generation time and may lag the provider card; `GET /v1/models` and the portal's pricing page are authoritative for billing.

> **[Browse all models](/models)**
>
> Search and filter every model by modality, maker, capability and price.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.