List Available Voices

Get list of available voices for video generation

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

language · string

Filter voices by language code (e.g., “en”, “fr”, “es”, “de”).

gender · string

Filter voices by gender: male or female.

tags · string

Comma-separated list of tags to filter by (e.g., “professional,friendly”).

Response

Array of available voice objects:

id · string

Unique identifier for the voice (use this in generation requests).

name · string

Human-readable name of the voice.

language · string

Language code (e.g., “en”, “fr”, “es”).

accent · string

Specific accent or region (e.g., “US”, “UK”, “CA”).

gender · string

Voice gender: male or female.

tags · array

Array of descriptive tags (e.g., [“professional”, “warm”, “energetic”]).

preview · string

URL to a short audio preview of the voice.

Example

cURL

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"

Success Response

[
  {
    "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"
  }
]