Skip to main content
GET

Gerar Demonstração de Voz

Gerar um arquivo de áudio de demonstração para um modelo de voz específico. Permite testar como uma voz soa antes de usá-la em suas chamadas.

Endpoint

Parâmetros de caminho

string
obrigatório
O identificador único do modelo de voz. Você pode encontrá-lo na lista de modelos de voz.

Cabeçalhos da requisição

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

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

string
obrigatório
URL assinada para download do arquivo de áudio de demonstração em formato MP3.

Respostas de erro

404 Não Encontrado

401 Não Autorizado

500 Erro do Servidor

Códigos de erro

Notas Importantes

URLs assinadas. O URL retornado é temporário e expira após um período determinado.
Formato MP3. Os arquivos de demonstração são fornecidos em formato MP3 para compatibilidade.
Geração sob demanda. O áudio de demonstração é gerado quando solicitado.
URLs temporários. Baixe o arquivo imediatamente, pois o URL pode expirar.

Melhores Práticas

  1. Teste antes de usar - Sempre teste as vozes antes de usá-las em produção
  2. Baixe rapidamente - Os URLs são temporários, então baixe o arquivo imediatamente
  3. Compare vozes - Use este endpoint para comparar diferentes modelos de voz
  4. Trate erros - Implemente tratamento adequado de erros para falhas de geração
  5. Monitore qualidade - Verifique se a qualidade da voz atende às suas necessidades

Endpoints relacionados

  • Listar Modelos de Voz: GET /api/v1/voice-templates
  • Listar Números de Telefone: GET /api/v1/phone-numbers