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

# Obter vozes disponíveis

> Recuperar todas as vozes disponíveis para configuração de assistentes.

Este endpoint retorna uma lista de todas as vozes disponíveis que podem ser utilizadas para criar ou atualizar os assistentes, com filtragem opcional por modo de assistente.

### Parâmetros de Consulta

<ParamField query="mode" type="string" optional>
  Filtrar vozes por modo de assistente. Opções: `pipeline`, `multimodal`
</ParamField>

### Campos de Resposta

<ResponseField name="data" type="array">
  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      O identificador único da voz
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome de exibição da voz
    </ResponseField>

    <ResponseField name="mode" type="string">
      O modo de assistente com o qual esta voz é compatível (`pipeline` ou `multimodal`)
    </ResponseField>

    <ResponseField name="preview_url" type="string">
      URL para uma amostra de áudio da voz. Pode ser usado para permitir que os usuários visualizem as vozes antes de selecionar uma.
    </ResponseField>

    <ResponseField name="accent" type="string">
      O sotaque da voz (por exemplo, "American", "British"). Pode ser `null`.
    </ResponseField>

    <ResponseField name="age" type="string">
      A categoria de idade da voz (por exemplo, "Young", "Middle aged"). Pode ser `null`.
    </ResponseField>

    <ResponseField name="synthesizer_provider_id" type="integer">
      O ID do provedor TTS ao qual esta voz pertence. Use o endpoint [Get Synthesizer Providers](/api-reference/assistants/get-synthesizer-providers) para resolver nomes de provedores. Pode ser `null`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response 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>

### Observações

* Use o campo `id` ao criar ou atualizar assistentes
* O campo `mode` indica com qual engine de assistente a voz é compatível
* Filtre por modo para obter apenas vozes compatíveis com o tipo de assistente pretendido
* Se nenhum filtro de modo for fornecido, todas as vozes disponíveis serão retornadas
* Apenas vozes que são públicas ou pertencem ao usuário autenticado são retornadas