# 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 1: Gerar demonstração para um modelo de voz
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"mp3_url": "https://example.com/storage/demo-audio/signed-url-here.mp3"
}
Modelos de Voz e Números de Telefone
Gerar Demonstração de Voz
Gerar um arquivo de áudio de demonstração para um modelo de voz específico
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"
// Requisição 1: Gerar demonstração para um modelo de voz
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"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
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_hereExemplos 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 1: Gerar demonstração para um modelo de voz
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# 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"
// Requisição 2: Gerar demonstração com ID específico
const voice_template_id = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(`https://app.talkover.ai/api/v1/voice-templates/${voice_template_id}/demo`, {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
Resposta
Resposta de Sucesso (200 OK)
{
"mp3_url": "https://example.com/storage/demo-audio/signed-url-here.mp3"
}
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
{
"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ódigo | Descrição | Status HTTP |
|---|---|---|
VOICE_TEMPLATE_NOT_FOUND | Modelo de voz especificado não existe | 404 |
INVALID_TOKEN | Token de autenticação inválido ou ausente | 401 |
GENERATION_FAILED | Falha ao gerar áudio de demonstração | 500 |
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
- Teste antes de usar - Sempre teste as vozes antes de usá-las em produção
- Baixe rapidamente - Os URLs são temporários, então baixe o arquivo imediatamente
- Compare vozes - Use este endpoint para comparar diferentes modelos de voz
- Trate erros - Implemente tratamento adequado de erros para falhas de geração
- 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
Esta página foi útil?