Overview
This endpoint returns all available voices that you can use in video generation. The voices are filtered based on your plan level, and include both system voices and any custom voices you’ve uploaded.
Authentication
This endpoint requires API key authentication. Include your API key in the Authorization header.
Query Parameters
Filter voices by language code (e.g., “en”, “fr”, “es”, “de”).
Filter voices by gender: male or female.
Comma-separated list of tags to filter by (e.g., “professional,friendly”).
Response
Array of available voice objects:
Unique identifier for the voice (use this in generation requests).
Human-readable name of the voice.
Language code (e.g., “en”, “fr”, “es”).
Specific accent or region (e.g., “US”, “UK”, “CA”).
Voice gender: male or female.
Array of descriptive tags (e.g., [“professional”, “warm”, “energetic”]).
URL to a short audio preview of the voice.
Example
curl -X GET "https://app.hoox.video/api/public/v1/resources/voices" \
-H "Authorization: Bearer your_api_key"
# With filters
curl -X GET "https://app.hoox.video/api/public/v1/resources/voices?language=en&gender=female&tags=professional" \
-H "Authorization: Bearer your_api_key"
[
{
"id": "voice_en_us_female_sarah",
"name": "Sarah",
"language": "en",
"accent": "US",
"gender": "female",
"tags": ["professional", "warm", "news"],
"preview": "https://storage.hoox.video/voices/previews/voice_en_us_female_sarah.mp3"
},
{
"id": "voice_en_uk_male_james",
"name": "James",
"language": "en",
"accent": "UK",
"gender": "male",
"tags": ["authoritative", "documentary", "deep"],
"preview": "https://storage.hoox.video/voices/previews/voice_en_uk_male_james.mp3"
},
{
"id": "voice_fr_fr_female_marie",
"name": "Marie",
"language": "fr",
"accent": "FR",
"gender": "female",
"tags": ["elegant", "professional", "clear"],
"preview": "https://storage.hoox.video/voices/previews/voice_fr_fr_female_marie.mp3"
},
{
"id": "custom_voice_user_123",
"name": "My Custom Voice",
"language": "en",
"accent": "US",
"gender": "female",
"tags": ["custom", "brand"],
"preview": "https://storage.hoox.video/voices/previews/custom_voice_user_123.mp3"
}
]
