# Request 1: Get all voice templates
curl -X GET "https://app.talkover.ai/api/v1/voice-templates" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Get all voice templates
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"data": [
{
"display_name": "Bianca",
"voices": [
{
"id": "voice-template-uuid-1",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "basic",
"cost": "0.10"
},
{
"id": "voice-template-uuid-2",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "pro",
"cost": "0.16"
},
{
"id": "voice-template-uuid-3",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "ultra",
"cost": "0.23"
}
]
},
{
"display_name": "Isabela",
"voices": [
{
"id": "voice-template-uuid-4",
"name": "Isabela",
"gender": "female",
"language": "pt-BR",
"quality_tier": "basic",
"cost": "0.10"
},
{
"id": "voice-template-uuid-5",
"name": "Isabela",
"gender": "female",
"language": "pt-BR",
"quality_tier": "pro",
"cost": "0.16"
}
]
}
]
}
Voice Templates & Phone Numbers
List Voice Templates
Retrieve a list of available voice templates grouped by display name
GET
/
api
/
v1
/
voice-templates
# Request 1: Get all voice templates
curl -X GET "https://app.talkover.ai/api/v1/voice-templates" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Get all voice templates
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
{
"success": true,
"data": [
{
"display_name": "Bianca",
"voices": [
{
"id": "voice-template-uuid-1",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "basic",
"cost": "0.10"
},
{
"id": "voice-template-uuid-2",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "pro",
"cost": "0.16"
},
{
"id": "voice-template-uuid-3",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "ultra",
"cost": "0.23"
}
]
},
{
"display_name": "Isabela",
"voices": [
{
"id": "voice-template-uuid-4",
"name": "Isabela",
"gender": "female",
"language": "pt-BR",
"quality_tier": "basic",
"cost": "0.10"
},
{
"id": "voice-template-uuid-5",
"name": "Isabela",
"gender": "female",
"language": "pt-BR",
"quality_tier": "pro",
"cost": "0.16"
}
]
}
]
}
List Voice Templates
Retrieve a list of available voice templates grouped by display name. This endpoint returns voice templates with different quality tiers and languages that can be used for voice agents.Endpoint
GET /api/v1/voice-templates
Request headers
string
required
Bearer token for authentication. Format:
Bearer talq_your_environment_token_hereQuery parameters
string
Filter by language (e.g.,
en-US, pt-BR)string
Filter by quality tier. Options:
basic, pro, ultra, betastring
Filter by gender. Options:
male, femaleExample requests
# Request 1: Get all voice templates
curl -X GET "https://app.talkover.ai/api/v1/voice-templates" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 1: Get all voice templates
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# Request 2: Get Portuguese voice templates
curl -X GET "https://app.talkover.ai/api/v1/voice-templates?language=pt-BR" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 2: Get Portuguese voice templates
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates?language=pt-BR', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
# Request 3: Get female pro quality templates
curl -X GET "https://app.talkover.ai/api/v1/voice-templates?gender=female&quality_tier=pro" \
-H "Authorization: Bearer talq_your_environment_token_here"
// Request 3: Get female pro quality templates
const response = await fetch('https://app.talkover.ai/api/v1/voice-templates?gender=female&quality_tier=pro', {
method: 'GET',
headers: {
'Authorization': 'Bearer talq_your_environment_token_here'
}
});
const result = await response.json();
console.log(result);
Response
Success Response (200 OK)
{
"success": true,
"data": [
{
"display_name": "Bianca",
"voices": [
{
"id": "voice-template-uuid-1",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "basic",
"cost": "0.10"
},
{
"id": "voice-template-uuid-2",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "pro",
"cost": "0.16"
},
{
"id": "voice-template-uuid-3",
"name": "Bianca",
"gender": "female",
"language": "pt-BR",
"quality_tier": "ultra",
"cost": "0.23"
}
]
},
{
"display_name": "Isabela",
"voices": [
{
"id": "voice-template-uuid-4",
"name": "Isabela",
"gender": "female",
"language": "pt-BR",
"quality_tier": "basic",
"cost": "0.10"
},
{
"id": "voice-template-uuid-5",
"name": "Isabela",
"gender": "female",
"language": "pt-BR",
"quality_tier": "pro",
"cost": "0.16"
}
]
}
]
}
Response fields
boolean
required
Indicates if the operation was successful.
array
required
Array of voice template groups.
Show Voice Template Group
Show Voice Template Group
string
required
The display name of the voice template group.
array
required
Array of voice templates with different quality tiers.
Show Voice Template
Show Voice Template
string
required
Unique identifier for the voice template.
string
required
Name of the voice template.
string
required
Gender of the voice. Options:
male, female.string
required
Language code of the voice (e.g.,
en-US, pt-BR).string
required
Quality tier of the voice. Options:
basic, pro, ultra, beta.string
required
Price per minute in USD.
Error responses
401 Unauthorized
{
"success": false,
"message": "Unauthorized"
}
422 Validation Error
{
"success": false,
"message": "The given data was invalid.",
"errors": {
"language": [
"The selected language is invalid."
],
"quality_tier": [
"The selected quality tier is invalid."
],
"gender": [
"The selected gender is invalid."
]
}
}
500 Server Error
{
"success": false,
"message": "Internal server error."
}
Error codes
| Code | Description | HTTP Status |
|---|---|---|
INVALID_TOKEN | Authentication token is invalid or missing | 401 |
VALIDATION_ERROR | Query parameter validation failed | 422 |
SERVER_ERROR | Internal server error occurred | 500 |
Important notes
Grouped by display name. Voice templates are grouped by their display name, with each group containing different quality tiers of the same voice.
Quality tiers affect cost. Higher quality tiers (pro, ultra) cost more per minute than basic tiers.
Language filtering. Use the language parameter to get voice templates for specific languages.
Related endpoints
- Generate Voice Template Demo:
GET /api/v1/voice-templates/{voiceTemplate}/demo - List Phone Numbers:
GET /api/v1/phone-numbers
Was this page helpful?