curl -X GET "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01" \
-H "Authorization: Bearer your_api_key"
import requests
url = "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01"
headers = {"Authorization": "Bearer your_api_key"}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://app.hoox.video/api/public/v1/voice/voice_fr_female_01', {
headers: {
'Authorization': 'Bearer your_api_key'
}
});
const data = await response.json();
console.log(data);
{
"id": "voice_fr_female_01",
"name": "Charlotte",
"language": "fr",
"gender": "female",
"tags": ["friendly", "warm"],
"source": "config"
}
{
"error": "Voice not found",
"details": [
{
"code": "NOT_FOUND",
"message": "Voice with id \"voice_fr_female_01\" not found"
}
]
}
Voices
Get Voice
Retrieve details of a specific voice by its ID
GET
/
api
/
public
/
v1
/
voice
/
{id}
curl -X GET "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01" \
-H "Authorization: Bearer your_api_key"
import requests
url = "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01"
headers = {"Authorization": "Bearer your_api_key"}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://app.hoox.video/api/public/v1/voice/voice_fr_female_01', {
headers: {
'Authorization': 'Bearer your_api_key'
}
});
const data = await response.json();
console.log(data);
{
"id": "voice_fr_female_01",
"name": "Charlotte",
"language": "fr",
"gender": "female",
"tags": ["friendly", "warm"],
"source": "config"
}
{
"error": "Voice not found",
"details": [
{
"code": "NOT_FOUND",
"message": "Voice with id \"voice_fr_female_01\" not found"
}
]
}
Overview
This endpoint retrieves details for a specific voice by itsid. Results can come from your space (custom voices) or from the public catalog filtered by your plan.
Authentication
This endpoint requires API key authentication. Include your API key in the
Authorization header.Path Parameters
string
required
The identifier of the voice to retrieve.
Response
string
Unique identifier of the voice.
string
Display name of the voice.
string
Language code of the voice (e.g.,
fr, en).string
Gender of the voice:
male or female.array
Array of tags associated with the voice (e.g.,
[\"friendly\", \"warm\"]).string
Source of the voice:
space (custom voice) or config (public catalog).Example
curl -X GET "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01" \
-H "Authorization: Bearer your_api_key"
import requests
url = "https://app.hoox.video/api/public/v1/voice/voice_fr_female_01"
headers = {"Authorization": "Bearer your_api_key"}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch('https://app.hoox.video/api/public/v1/voice/voice_fr_female_01', {
headers: {
'Authorization': 'Bearer your_api_key'
}
});
const data = await response.json();
console.log(data);
{
"id": "voice_fr_female_01",
"name": "Charlotte",
"language": "fr",
"gender": "female",
"tags": ["friendly", "warm"],
"source": "config"
}
{
"error": "Voice not found",
"details": [
{
"code": "NOT_FOUND",
"message": "Voice with id \"voice_fr_female_01\" not found"
}
]
}
Was this page helpful?