> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Récupérer les voix disponibles

> Récupérer toutes les voix disponibles pour la configuration des assistants

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison renvoie la liste de toutes les voix disponibles pouvant être utilisées lors de la création ou de la mise à jour d’assistants, avec un filtrage optionnel par mode d’assistant et par langue.

### Paramètres de requête

<ParamField query="mode" type="string">
  Filtrer les voix par mode d’assistant. Options : `pipeline`, `multimodal`, `dualplex`
</ParamField>

<ParamField query="language_id" type="integer">
  Filtrer les voix par ID de langue. Utilisez le point de terminaison [Récupérer les langues](/fr/api-v1/assistants/languages) pour obtenir les ID de langue disponibles.
</ParamField>

### Champs de réponse

<ResponseField name="data" type="array">
  <Expandable title="Propriétés">
    <ResponseField name="id" type="integer">
      L’identifiant unique de la voix
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom d’affichage de la voix
    </ResponseField>

    <ResponseField name="language_id" type="integer">
      L’ID de langue associé à cette voix
    </ResponseField>

    <ResponseField name="gender" type="string">
      Le genre de la voix (male/female)
    </ResponseField>

    <ResponseField name="preview_url" type="string">
      URL d’un échantillon audio de la voix. Permet aux utilisateurs d’écouter un aperçu de la voix avant de la sélectionner.
    </ResponseField>

    <ResponseField name="accent" type="string">
      L’accent de la voix (par ex. « American », « British »). Peut être `null`.
    </ResponseField>

    <ResponseField name="age" type="string">
      La catégorie d’âge de la voix (par ex. « Young », « Middle aged »). Peut être `null`.
    </ResponseField>

    <ResponseField name="synthesizer_provider_id" type="integer">
      L’ID du fournisseur TTS auquel appartient cette voix. Utilisez le point de terminaison [Récupérer les fournisseurs de synthèse vocale](/fr/api-v1/assistants/synthesizer-providers) pour résoudre les noms de fournisseurs. Peut être `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 response theme={null} theme={null}
  [
    {
      "id": 1,
      "name": "Alloy",
      "language_id": 1,
      "gender": "female",
      "preview_url": "https://cdn.openai.com/API/voice-previews/alloy.flac",
      "accent": null,
      "age": "Middle aged",
      "synthesizer_provider_id": null
    },
    {
      "id": 10,
      "name": "Zephyr",
      "language_id": 1,
      "gender": "female",
      "preview_url": "https://gstatic.com/aistudio/voices/samples/Zephyr.wav",
      "accent": null,
      "age": "Middle aged",
      "synthesizer_provider_id": 1
    },
    {
      "id": 11,
      "name": "Puck",
      "language_id": 1,
      "gender": "male",
      "preview_url": "https://gstatic.com/aistudio/voices/samples/Puck.wav",
      "accent": null,
      "age": "Middle aged",
      "synthesizer_provider_id": 1
    }
  ]
  ```
</ResponseExample>

### Remarques

* Utilisez le champ `id` comme `voice_id` lors de la création ou de la mise à jour d’assistants
* Filtrez par `mode` pour ne récupérer que les voix compatibles avec le type d’assistant souhaité
* Filtrez par `language_id` pour obtenir les voix d’une langue spécifique
* Si aucun filtre n’est spécifié, toutes les voix disponibles sont renvoyées
* Seules les voix publiques ou appartenant à l’utilisateur authentifié sont renvoyées