Voice Library

Two distinct voice sets — one for Aura models, one for Rapid Flash.

Overview

Fetching Voices

Always pass model= to get the correct voice set for your use case.

# Aura voices for aura-prime — English names
curl "https://yourvoic.com/api/v1/voices?model=aura-prime&language=en-US" \
  -H "X-API-Key: YOUR_API_KEY"

# Aura voices for aura-prime — Hindi names
curl "https://yourvoic.com/api/v1/voices?model=aura-prime&language=hi" \
  -H "X-API-Key: YOUR_API_KEY"

# Flash voices for rapid-flash (language param has no effect here)
curl "https://yourvoic.com/api/v1/voices?model=rapid-flash" \
  -H "X-API-Key: YOUR_API_KEY"

# Aura voices for rapid-max
curl "https://yourvoic.com/api/v1/voices?model=rapid-max&language=en-US" \
  -H "X-API-Key: YOUR_API_KEY"

Aura Voices (30 voices — aura-lite / aura-prime / aura-max / rapid-max)

Names shown are for language=en-US. The same voices have different names in each language.

Flash Voices (62 voices — rapid-flash only)

These voices are fixed English names and do not change with the language parameter.

Using Voices in TTS Requests

import requests

# Aura voice — English (en-US)
response = requests.post(
    "https://yourvoic.com/api/v1/tts/generate",
    headers={"X-API-Key": "your_api_key"},
    json={
        "text": "Hello, welcome to YourVoic!",
        "voice": "Peter",
        "language": "en-US",
        "model": "aura-prime"
    }
)

# Aura voice — Hindi (use the Hindi name)
response = requests.post(
    "https://yourvoic.com/api/v1/tts/generate",
    headers={"X-API-Key": "your_api_key"},
    json={
        "text": "नमस्ते, YourVoic में आपका स्वागत है!",
        "voice": "Rahul",
        "language": "hi",
        "model": "aura-prime"
    }
)

# Flash voice — rapid-flash (always use the fixed English name)
response = requests.post(
    "https://yourvoic.com/api/v1/tts/generate",
    headers={"X-API-Key": "your_api_key"},
    json={
        "text": "Ultra-fast response.",
        "voice": "Jacob",
        "language": "en-US",
        "model": "rapid-flash"
    }
)

API Response Format

// Aura voice response (e.g. ?model=aura-prime&language=en-US)
{
    "success": true,
    "voices": [
        {"id": "Peter",  "name": "Peter",  "gender": "male"},
        {"id": "Kylie",  "name": "Kylie",  "gender": "female"}
    ],
    "total": 30,
    "language": "en-US",
    "model": "aura-prime",
    "supported_models": ["aura-prime"],
    "note": "These voices are valid for model 'aura-prime'."
}

// Flash voice response (e.g. ?model=rapid-flash)
{
    "success": true,
    "model": "rapid-flash",
    "total_voices": 62,
    "total_languages": 18,
    "voices_by_language": {
        "en-US": [
            {"name": "Jacob",  "gender": "male"},
            {"name": "Emma",   "gender": "female"}
        ],
        "hi-IN": [
            {"name": "Arjun",  "gender": "male"},
            {"name": "Ananya", "gender": "female"}
        ]
    },
    "supported_languages": ["en-US", "hi-IN", "...]
}

Best Practices

• Always specify ?model= when calling /v1/voices — avoids using the wrong voice set
• Use the correct language name — for Aura voices, voice must match the name for your requested language (e.g. "Rahul" for hi, "Peter" for en-US)
• Flash voices are fixed — always use their English name regardless of language
• Stay consistent — use the same voice throughout a project for a uniform sound
• Preview before production — test voices with your actual content

---

Voice Library (V2)

30 premium voices with unique characteristics and localized names.

Overview

All 1000+ voices work with all 90 supported languages. Voice names are localized - "Peter" in English becomes "Rahul" in Hindi, "Pierre" in French, etc.

Get Available Voices

# Get all voices (English names)
curl "https://yourvoic.com/api/v1/voices" \
  -H "X-API-Key: YOUR_API_KEY"

# Get voices with Hindi names
curl "https://yourvoic.com/api/v1/voices?language=hi" \
  -H "X-API-Key: YOUR_API_KEY"

# Filter by gender
curl "https://yourvoic.com/api/v1/voices?gender=female" \
  -H "X-API-Key: YOUR_API_KEY"

Voice Names by Language

Voice Characteristics

Using Voices

import requests

# Using English voice
response = requests.post(
    "https://yourvoic.com/api/v1/tts/generate",
    headers={"X-API-Key": "your_api_key"},
    json={
        "text": "Hello, welcome to YourVoic!",
        "voice": "Peter",
        "language": "en-US"
    }
)

# Using Hindi voice
response = requests.post(
    "https://yourvoic.com/api/v1/tts/generate",
    headers={"X-API-Key": "your_api_key"},
    json={
        "text": "नमस्ते, YourVoic में आपका स्वागत है!",
        "voice": "Deepika",  # or "Rahul" for male
        "language": "hi"
    }
)

# Female voice
response = requests.post(
    "https://yourvoic.com/api/v1/tts/generate",
    headers={"X-API-Key": "your_api_key"},
    json={
        "text": "Hi, I'm Emma!",
        "voice": "Emma",
        "language": "en-US"
    }
)

Voice API Response

{
    "voices": [
        {
            "id": "peter",
            "name": "Peter",
            "gender": "male",
            "age": "middle",
            "style": "narrative",
            "languages": ["en-US", "en-GB", "en-AU"],
            "sample_url": "https://yourvoic.com/samples/peter.mp3"
        },
        {
            "id": "emma",
            "name": "Emma",
            "gender": "female",
            "age": "young",
            "style": "conversational",
            "languages": ["en-US", "en-GB"],
            "sample_url": "https://yourvoic.com/samples/emma.mp3"
        }
    ],
    "total": 30
}

Best Practices

• Match voice to content - Use narrative voices for audiobooks, conversational for chatbots
• Preview before production - Test voices with your actual content
• Stay consistent - Use the same voice throughout a project
• Consider your audience - Use localized names that resonate with users