Modelos de Voz e Números de Telefone
Listar Modelos de Voz
Recuperar uma lista de modelos de voz disponíveis agrupados por nome de exibição
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_hereParâmetros de consulta
string
Filtrar por idioma (ex:
en-US, pt-BR)string
Filtrar por nível de qualidade. Opções:
basic, pro, ultra, betastring
Filtrar por gênero. Opções:
male, femaleExemplos 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
- Filtre por idioma - Use o parâmetro
languagepara obter vozes no idioma desejado - Considere a qualidade - Escolha o nível de qualidade adequado para seu caso de uso
- Teste as vozes - Use o endpoint de demonstração para testar as vozes antes de usar
- Monitore custos - Diferentes níveis de qualidade têm custos diferentes
- 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