Skip to main content
GET
/
user
/
assistants
/
voices
Obter vozes disponíveis
curl --request GET \
  --url https://suasofia.online/api/user/assistants/voices \
  --header 'Authorization: Bearer <token>'
[
  {
    "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
  }
]
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

​
mode
string
Filtrar vozes por modo de assistente. Opções: pipeline, multimodal

​
Campos de Resposta

​
data
array
[
  {
    "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
  }
]

​
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