Maximum number of voices to return
Audio Voices Endpoints
API for managing custom voice profiles.
Examples
Real world code examples
List all voices
GET /v1/audio/voices
List all voices (excluding sample data)
limit
offset
Offset for pagination
200
Successful Response
Playground
Test the endpoints live
curl https://api.mistral.ai/v1/audio/voices \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/audio/voices \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"items": [
{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}
],
"page": 87,
"page_size": 14,
"total": 56,
"total_pages": 91
}{
"items": [
{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}
],
"page": 87,
"page_size": 14,
"total": 56,
"total_pages": 91
}Create a new voice
POST /v1/audio/voices
Create a new voice with a base64-encoded audio sample
Request model for creating a new voice with base64 audio.
age
color
gender
languages
name
retention_notice
Default Value: 30
sample_audio
Base64-encoded audio file
sample_filename
Original filename for extension detection
slug
tags
200
Successful Response
age
color
created_at
gender
id
languages
name
retention_notice
Default Value: 30
slug
tags
user_id
Playground
Test the endpoints live
curl https://api.mistral.ai/v1/audio/voices \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"name": "ipsum eiusmod",
"sample_audio": "consequat do"
}'curl https://api.mistral.ai/v1/audio/voices \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"name": "ipsum eiusmod",
"sample_audio": "consequat do"
}'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}Get voice details
GET /v1/audio/voices/{voice_id}
Get voice details (excluding sample)
voice_id
200
Successful Response
age
color
created_at
gender
id
languages
name
retention_notice
Default Value: 30
slug
tags
user_id
Playground
Test the endpoints live
curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}Delete a custom voice
DELETE /v1/audio/voices/{voice_id}
Delete a custom voice
voice_id
200
Successful Response
age
color
created_at
gender
id
languages
name
retention_notice
Default Value: 30
slug
tags
user_id
Playground
Test the endpoints live
curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}Update voice metadata
PATCH /v1/audio/voices/{voice_id}
Update voice metadata (name, gender, languages, age, tags).
voice_id
Request model for partially updating voice metadata.
age
gender
languages
name
tags
200
Successful Response
age
color
created_at
gender
id
languages
name
retention_notice
Default Value: 30
slug
tags
user_id
Playground
Test the endpoints live
curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'200
{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}{
"created_at": "2025-10-07T20:56:01.974Z",
"id": "ipsum eiusmod",
"name": "consequat do",
"user_id": null
}Get voice sample audio
GET /v1/audio/voices/{voice_id}/sample
Get the audio sample for a voice
voice_id
200
Response Type
string
Successful Response
Playground
Test the endpoints live
curl https://api.mistral.ai/v1/audio/voices/{voice_id}/sample \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/audio/voices/{voice_id}/sample \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
"ipsum eiusmod""ipsum eiusmod"