Voxtral TTS 3
Mistral's Voxtral TTS 3 — 66 preset voices with emotion and pace tags.
/v1/media/queueOverview
Voxtral TTS 3 is Mistral's text-to-speech model. It converts text into natural-sounding speech, offers a library of 66 preset voices — emotion-tagged speakers such as en_paul_happy and gb_jane_sarcasm alongside numbered voices — and accepts emotion and pace tags in the input for directing delivery.
| Property | Value |
|---|---|
| Model ID | mistralai/voxtral-mini-tts-3-0 |
| Alias | voxtral-3 |
| Upstream Model | mistralai/voxtral-mini-tts-3-0 |
| Category | Text to Speech |
| Languages | English (US and UK) and French named voices |
| Output | mp3 (default) or pcm |
| Pricing | $0.0302 per 1,000 characters |
Usage
All media models use the async job queue. Submit a job, then poll for the result.
Step 1: Submit Job
const res = await fetch('https://api.yepapi.com/v1/media/queue', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'mistralai/voxtral-mini-tts-3-0',
prompt: 'Your text to speak goes here.',
options: { voice: 'en_paul_neutral' },
}),
});
const { data } = await res.json();
// data.jobId — use this to poll for resultscurl -X POST https://api.yepapi.com/v1/media/queue \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "mistralai/voxtral-mini-tts-3-0", "prompt": "Your text to speak goes here."}'Step 2: Poll for Result
const status = await fetch(`https://api.yepapi.com/v1/media/status/${data.jobId}`, {
headers: { 'x-api-key': 'YOUR_API_KEY' },
});
const { data: job } = await status.json();
// job.status — "pending" | "processing" | "completed" | "failed"
// job.result.audio — { mimeType, base64 } when completedcurl https://api.yepapi.com/v1/media/status/JOB_ID \
-H "x-api-key: YOUR_API_KEY"Write the audio to a file:
import { writeFileSync } from 'node:fs';
writeFileSync('speech.mp3', Buffer.from(job.result.audio.base64, 'base64'));Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
model | string | Yes | mistralai/voxtral-mini-tts-3-0 | — |
prompt | string | Yes | The text to speak (max 50,000 bytes) | — |
options.voice | string | No | Voice identifier | en_paul_neutral |
options.outputFormat | string | No | mp3 (default) or pcm | mp3 |
options.speed | number | No | Playback speed multiplier. Honoured only by models that support it | 1.0 |
Voices
en_paul_neutral is used when options.voice is omitted. 66 voices available (10 of 66 shown):
en_paul_neutralen_paul_happyen_paul_saden_paul_angrygb_oliver_neutralgb_oliver_curiousgb_jane_sarcasmgb_jane_confidentfr_marie_neutralvoice_3150
Features
- 66 preset voices
- Emotion-tagged named speakers (neutral, happy, sad, angry, confident…)
- Emotion and pace tags in the input text
- Natural-sounding speech from one Mistral model
Billing
Speech is billed on the length of the input text, in UTF-8 bytes — for English text one byte is one character. The cost is known before synthesis starts, so the balance check at submit time quotes the exact final charge. Jobs have a $0.01 minimum.
Powered by OpenRouter's unified speech API.