Skip to main content
GET

Listar Modelos de Voz

Recuperar uma lista de modelos de voz disponíveis agrupados por nome de exibição, com opções de filtragem por idioma, qualidade e gênero.

Endpoint

Cabeçalhos da requisição

string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

Parâmetros de consulta

string
Filtrar por idioma (ex: en-US, pt-BR)
string
Filtrar por nível de qualidade. Opções: basic, pro, ultra, beta
string
Filtrar por gênero. Opções: male, female

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

boolean
obrigatório
Indica se a operação foi bem-sucedida.
array
obrigatório
Array de grupos de modelos de voz.

Respostas de erro

401 Não Autorizado

422 Erro de Validação

500 Erro do Servidor

Códigos de erro

Notas Importantes

Agrupamento por nome. Os modelos de voz são agrupados por nome de exibição para facilitar a seleção.
Filtros disponíveis. Use os parâmetros de consulta para filtrar por idioma, qualidade e gênero.
Custos variáveis. Cada nível de qualidade tem um custo diferente por minuto.

Melhores Práticas

  1. Filtre por idioma - Use o parâmetro language para obter vozes no idioma desejado
  2. Considere a qualidade - Escolha o nível de qualidade adequado para seu caso de uso
  3. Teste as vozes - Use o endpoint de demonstração para testar as vozes antes de usar
  4. Monitore custos - Diferentes níveis de qualidade têm custos diferentes
  5. Trate erros - Implemente tratamento adequado de erros para falhas de autenticação e validação

Endpoints relacionados

  • Gerar Demonstração de Voz: GET /api/v1/voice-templates/{voice_template_id}/demo
  • Listar Números de Telefone: GET /api/v1/phone-numbers