Pular para o conteúdo principal
GET
/
api
/
v1
/
voice-templates
/
{voice_template_id}
/
demo
# Requisição 1: Gerar demonstração para um modelo de voz
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "mp3_url": "https://example.com/storage/demo-audio/signed-url-here.mp3"
}

​
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

GET /api/v1/voice-templates/{voice_template_id}/demo

​
Parâmetros de caminho

​
voice_template_id
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

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

​
Exemplos de Requisição

# Requisição 1: Gerar demonstração para um modelo de voz
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo" \
  -H "Authorization: Bearer talq_your_environment_token_here"

# Requisição 2: Gerar demonstração com ID específico
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/550e8400-e29b-41d4-a716-446655440000/demo" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Resposta

​
Resposta de Sucesso (200 OK)

{
  "mp3_url": "https://example.com/storage/demo-audio/signed-url-here.mp3"
}

​
Campos da Resposta

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

​
Respostas de erro

​
404 Não Encontrado

{
  "success": false,
  "message": "Voice template not found"
}

​
401 Não Autorizado

{
  "success": false,
  "message": "Unauthorized"
}

​
500 Erro do Servidor

{
  "success": false,
  "message": "Failed to generate demo audio"
}

​
Códigos de erro

CódigoDescriçãoStatus HTTP
VOICE_TEMPLATE_NOT_FOUNDModelo de voz especificado não existe404
INVALID_TOKENToken de autenticação inválido ou ausente401
GENERATION_FAILEDFalha ao gerar áudio de demonstração500

​
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