La spec OpenAPI
Home
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Voix audio

Lister toutes les voix

GET /v1/audio/voices

Lister toutes les voix (à l'exclusion des données d'exemple)

200

Réponse réussie

items
*array<VoiceResponse>
page
*integer
page_size
*integer
total
*integer
total_pages
*integer

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/audio/voices \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "items": [
    {
      "created_at": "2025-12-17T10:25:07.818693Z",
      "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
      "name": "My resource",
      "user_id": null
    }
  ],
  "page": "1",
  "page_size": "1000",
  "total": 56,
  "total_pages": "1"
}

Créer une nouvelle voix

POST /v1/audio/voices

Créer une nouvelle voix avec un échantillon audio encodé en base64

200

Réponse réussie

age
integer|null
color
string|null
created_at
*date-time
description
string|null
gender
string|null
id
*string
languages
array<string>
name
*string
retention_notice
integer

Default Value: 30

slug
string|null
tags
array<string>|null
trimmed_seconds
number|null
user_id
*string|null

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/audio/voices \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My voice",
  "sample_audio": "base64-encoded-audio-data"
}'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "user_id": null
}

Obtenir les détails d'une voix

GET /v1/audio/voices/{voice_id}

Obtenir les détails d'une voix (à l'exclusion de l'échantillon)

200

Réponse réussie

age
integer|null
color
string|null
created_at
*date-time
description
string|null
gender
string|null
id
*string
languages
array<string>
name
*string
retention_notice
integer

Default Value: 30

slug
string|null
tags
array<string>|null
trimmed_seconds
number|null
user_id
*string|null

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/audio/voices/{voice_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "user_id": null
}

Supprimer une voix personnalisée

DELETE /v1/audio/voices/{voice_id}

Supprimer une voix personnalisée

200

Réponse réussie

age
integer|null
color
string|null
created_at
*date-time
description
string|null
gender
string|null
id
*string
languages
array<string>
name
*string
retention_notice
integer

Default Value: 30

slug
string|null
tags
array<string>|null
trimmed_seconds
number|null
user_id
*string|null

Playground

Testez les endpoints en direct

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-12-17T10:25:07.818693Z",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "user_id": null
}

Mettre à jour les métadonnées de la voix

PATCH /v1/audio/voices/{voice_id}

Mettre à jour les métadonnées de la voix (nom, genre, langues, âge, balises).

200

Réponse réussie

age
integer|null
color
string|null
created_at
*date-time
description
string|null
gender
string|null
id
*string
languages
array<string>
name
*string
retention_notice
integer

Default Value: 30

slug
string|null
tags
array<string>|null
trimmed_seconds
number|null
user_id
*string|null

Playground

Testez les endpoints en direct

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-12-17T10:25:07.818693Z",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "name": "My resource",
  "user_id": null
}

Obtenir l'audio de l'échantillon de la voix

GET /v1/audio/voices/{voice_id}/sample

Obtenir l'échantillon audio d'une voix

200

Response Type
binary

Réponse réussie

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/audio/voices/{voice_id}/sample \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

"base64-encoded-data"