Voices

This page lists the preset voices you can pass to a speech request, and shows how to list, hear, create, and manage voices through the API.

Mistral provides two sets of preset voices. Pass the voice ID to any speech request.

The following voices come with Voxtral 3.

Voxtral 3 still accepts these presets. Each speaker comes in several variants, one per emotion: choose the variant that matches the delivery you want.

Pass the voice ID as voice_id in a speech request. A preset voice has a slug, such as gb_jane_neutral or voice_478. A voice saved in your workspace has no slug: use the ID that the API returns when you create it. If the ID doesn't match any voice, the request fails with a 404 error.

The voices API covers the preset voices and the voices saved in your workspace. The following table shows what each operation applies to.

import os

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# List all preset voices
page = client.audio.voices.search(page_size=50, type_="preset")
while page is not None:
    for voice in page.result.data:
        languages = ", ".join(voice.languages or []) or "-"
        print(f"{voice.slug or voice.id:<38} {voice.name:<28} {voice.type:<7} {languages}")
    page = page.next()

# Filter by language and gender
page = client.audio.voices.search(
    language=["fr"],
    gender=["female"],
)
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

# Search by name
page = client.audio.voices.search(query="Marie")
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

import os

from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# List all preset voices
page = client.audio.voices.search(page_size=50, type_="preset")
while page is not None:
    for voice in page.result.data:
        languages = ", ".join(voice.languages or []) or "-"
        print(f"{voice.slug or voice.id:<38} {voice.name:<28} {voice.type:<7} {languages}")
    page = page.next()

# Filter by language and gender
page = client.audio.voices.search(
    language=["fr"],
    gender=["female"],
)
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

# Search by name
page = client.audio.voices.search(query="Marie")
for voice in page.result.data:
    print(f"{voice.name}: {voice.slug}")

The examples read the recording from voice_sample.mp3 in the working directory, and the voice ID to manage from the VOICE_ID environment variable. Saved voices carry a retention_notice field (default 30 days, min 1, max 365). Set it when creating or updating a voice via the API. Voices created from the AI Studio UI default to 30 days.

Saved voices can be shared within your workspace. Sharing is managed in AI Studio: workspace admins control whether a voice is private or shared with the workspace. The sharing_scope field in the voice list response indicates the current scope (private, workspace, or global). The sharing API endpoints are internal for now; sharing is done through the AI Studio interface.