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

Endpoints Voix audio

API pour gérer les profils de voix personnalisés.

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-10-07T20:56:01.974Z",
      "id": "ipsum eiusmod",
      "name": "consequat do",
      "user_id": null
    }
  ],
  "page": 87,
  "page_size": 14,
  "total": 56,
  "total_pages": 91
}

Créer une nouvelle voix

POST /v1/audio/voices

Créez 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
gender
string|null
id
*string
languages
array<string>
name
*string
retention_notice
integer

Valeur par défaut : 30

slug
string|null
tags
array<string>|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": "ipsum eiusmod",
  "sample_audio": "consequat do"
}'

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "id": "ipsum eiusmod",
  "name": "consequat do",
  "user_id": null
}

Obtenir les détails d'une voix

GET /v1/audio/voices/{voice_id}

Obtenir les détails d'une voix (échantillon exclu)

200

Réponse réussie

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

Valeur par défaut : 30

slug
string|null
tags
array<string>|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-10-07T20:56:01.974Z",
  "id": "ipsum eiusmod",
  "name": "consequat do",
  "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
gender
string|null
id
*string
languages
array<string>
name
*string
retention_notice
integer

Valeur par défaut : 30

slug
string|null
tags
array<string>|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-10-07T20:56:01.974Z",
  "id": "ipsum eiusmod",
  "name": "consequat do",
  "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, tags).

200

Réponse réussie

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

Valeur par défaut : 30

slug
string|null
tags
array<string>|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-10-07T20:56:01.974Z",
  "id": "ipsum eiusmod",
  "name": "consequat do",
  "user_id": null
}

Obtenir l'échantillon audio de la voix

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

Obtenir l'échantillon audio d'une voix

200

Response Type
string

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

"ipsum eiusmod"