# Request 1: Generate demo for a specific voice template
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Generate demo for a specific voice template
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"
}
Voice Templates & Phone Numbers
Generate Voice Template Demo
Generate a demo audio file for a specific voice template
GET
/
api
/
v1
/
voice-templates
/
{voice_template_id}
/
demo
# Request 1: Generate demo for a specific voice template
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Generate demo for a specific voice template
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"
}
Generate Voice Template Demo
Generate a demo audio file for a specific voice template. This endpoint creates a sample audio file that demonstrates how the voice template sounds, allowing you to test and evaluate voice templates before using them in your agents.Endpoint
GET /api/v1/voice-templates/{voice_template_id}/demo
Path parameters
string
required
The unique identifier of the voice template. You can find this in the voice templates list.
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereExample requests
# Request 1: Generate demo for a specific voice template
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Generate demo for a specific voice template
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);
# Request 2: Generate demo with error handling
curl -X GET "https://app.talkover.ai/api/v1/voice-templates/voice-template-uuid-1/demo" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-w "\nHTTP Status: %{http_code}\n"
// Request 2: Generate demo with error handling
try {
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'
}
});
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
const result = await response.json();
console.log('Demo URL:', result.mp3_url);
} catch (error) {
console.error('Error generating demo:', error);
}
Response
Success Response (200 OK)
{
"mp3_url": "https://example.com/storage/demo-audio/signed-url-here.mp3"
}
Response fields
string
required
A signed URL to the generated demo audio file in MP3 format. This URL is temporary and will expire.
Error responses
404 Not Found
{
"success": false,
"message": "Voice template not found"
}
401 Unauthorized
{
"success": false,
"message": "Unauthorized"
}
500 Server Error
{
"error": "Failed to generate demo audio"
}
Error codes
| Code | Description | HTTP Status |
|---|---|---|
VOICE_TEMPLATE_NOT_FOUND | Specified voice template does not exist | 404 |
INVALID_TOKEN | Authentication token is invalid or missing | 401 |
DEMO_GENERATION_FAILED | Failed to generate demo audio | 500 |
Important notes
Temporary URLs. The demo audio URL is temporary and will expire after a certain time period.
Demo content. The demo audio contains a sample text that showcases the voice template’s capabilities.
Generation time. Demo audio generation may take a few seconds to complete.
Related endpoints
- List Voice Templates:
GET /api/v1/voice-templates - List Phone Numbers:
GET /api/v1/phone-numbers
Was this page helpful?