> ## 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.

# Obtener voces disponibles

> Obtén todas las voces disponibles para la configuración de asistentes

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint devuelve una lista de todas las voces disponibles que se pueden usar al crear o actualizar asistentes, con filtrado opcional por modo de asistente e idioma.

### Parámetros de consulta

<ParamField query="mode" type="string">
  Filtra las voces por modo de asistente. Opciones: `pipeline`, `multimodal`, `dualplex`
</ParamField>

<ParamField query="language_id" type="integer">
  Filtra las voces por ID de idioma. Usa el endpoint [Obtener idiomas](/es/api-v1/assistants/languages) para obtener los ID de idioma disponibles.
</ParamField>

### Campos de respuesta

<ResponseField name="data" type="array">
  <Expandable title="Propiedades">
    <ResponseField name="id" type="integer">
      El identificador único de la voz
    </ResponseField>

    <ResponseField name="name" type="string">
      El nombre visible de la voz
    </ResponseField>

    <ResponseField name="language_id" type="integer">
      El ID de idioma asociado a esta voz
    </ResponseField>

    <ResponseField name="gender" type="string">
      El género de la voz (male/female)
    </ResponseField>

    <ResponseField name="preview_url" type="string">
      URL a una muestra de audio de la voz. Se puede usar para permitir que los usuarios escuchen una vista previa de la voz antes de seleccionarla.
    </ResponseField>

    <ResponseField name="accent" type="string">
      El acento de la voz (p. ej., "American", "British"). Puede ser `null`.
    </ResponseField>

    <ResponseField name="age" type="string">
      La categoría de edad de la voz (p. ej., "Young", "Middle aged"). Puede ser `null`.
    </ResponseField>

    <ResponseField name="synthesizer_provider_id" type="integer">
      El ID del proveedor de TTS al que pertenece esta voz. Usa el endpoint [Obtener proveedores de síntesis de voz](/es/api-v1/assistants/synthesizer-providers) para resolver los nombres de los proveedores. Puede ser `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>

### Notas

* Usa el campo `id` como `voice_id` al crear o actualizar asistentes
* Filtra por `mode` para obtener solo las voces compatibles con el tipo de asistente que necesitas
* Filtra por `language_id` para obtener las voces de un idioma específico
* Si no se especifica ningún filtro, se devuelven todas las voces disponibles
* Solo se devuelven las voces que son públicas o que pertenecen al usuario autenticado