Skip to main content

Overview

VoxNexus offers a diverse library of high-quality voices covering multiple languages, accents, genders, and styles. Each voice is carefully crafted using advanced AI technology to deliver natural, expressive speech.

Voice Categories

By Language

Our voice library supports 50+ languages and locales:
  • English: Multiple accents (US, UK, Australian, etc.)
  • Chinese: Mandarin, Cantonese, and regional variants
  • Spanish: European and Latin American variants
  • French: European and Canadian French
  • German: Standard German and regional accents
  • Japanese: Standard Japanese
  • Korean: Standard Korean
  • And many more…

By Gender

Choose voices that match your application’s needs:
  • Male Voices: Deep, authoritative, or friendly male voices
  • Female Voices: Warm, professional, or energetic female voices
  • Neutral Voices: Gender-neutral options for inclusive applications

By Age Group

Select voices appropriate for your audience:
  • Child Voices: Young, energetic voices for children’s content
  • Young Voices: Youthful voices for modern applications
  • Adult Voices: Mature, professional voices for business applications
  • Senior Voices: Wise, experienced voices for authoritative content

By Style

Match voice style to your content:
  • Professional: Formal, business-appropriate voices
  • Casual: Friendly, conversational voices
  • Cheerful: Energetic, upbeat voices
  • Calm: Soothing, relaxed voices
  • Authoritative: Confident, commanding voices
  • Friendly: Warm, approachable voices

Discovering Voices

Browse All Voices

Use the /v1/voices endpoint to browse available voices:
curl -X GET "https://api.voxnexus.ai/v1/voices" \
  -H "Authorization: Bearer YOUR_API_KEY"

Search Voices

Search for voices by keyword:
curl -X GET "https://api.voxnexus.ai/v1/voices/search?q=xiaoxiao" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filter Voices

Filter voices by attributes:
# Filter by language
curl -X GET "https://api.voxnexus.ai/v1/voices?language=zh-CN" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter by gender
curl -X GET "https://api.voxnexus.ai/v1/voices?gender=female" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter by age
curl -X GET "https://api.voxnexus.ai/v1/voices?age=young" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Combine filters
curl -X GET "https://api.voxnexus.ai/v1/voices?language=zh-CN&gender=female&age=young" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Voice Details

Retrieve detailed information about a specific voice:
curl -X GET "https://api.voxnexus.ai/v1/voices/vl-xiaoxiao" \
  -H "Authorization: Bearer YOUR_API_KEY"

Voice Response Format

When you query the voice API, you’ll receive responses in this format:
{
  "voices": [
    {
      "voice_id": "vl-xiaoxiao",
      "name": "Xiaoxiao",
      "display_name": "Xiaoxiao",
      "language": "zh-CN",
      "locale": "zh-CN",
      "gender": "female",
      "age": "young",
      "description": "A cheerful and energetic voice",
      "styles": ["cheerful", "sad", "angry"],
      "sample_url": "https://api.example.com/api/v1/samples/vl-xiaoxiao",
      "voice_config_schema": {
        "style": {
          "type": "string",
          "enum": ["cheerful", "sad", "angry"]
        },
        "role": {
          "type": "string",
          "enum": ["Girl", "Boy"]
        },
        "degree": {
          "type": "number",
          "min": 0,
          "max": 1
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total": 150,
    "total_pages": 8
  }
}

Voice Configuration

Many voices support additional configuration options through the voice_config parameter:

Style Configuration

Some voices support different speaking styles:
{
  "text": "Hello, world!",
  "voice_id": "vl-xiaoxiao",
  "voice_config": {
    "style": "cheerful"
  }
}

Role Configuration

Some voices can adopt different roles:
{
  "text": "Hello, world!",
  "voice_id": "vl-xiaoxiao",
  "voice_config": {
    "role": "Girl",
    "degree": 0.5
  }
}

Checking Voice Configuration Options

Each voice’s voice_config_schema field describes the available configuration options. Check the voice details to see what’s supported:
const response = await fetch('https://api.voxnexus.ai/v1/voices/vl-xiaoxiao', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const voice = await response.json();
console.log('Available config options:', voice.voice_config_schema);

Chinese Voices

Xiaoxiao

A cheerful and energetic female voice, perfect for friendly applications.

Yunxi

A calm and professional male voice, ideal for business content.

English Voices

Jenny

A professional female voice with clear pronunciation.

Guy

A friendly male voice suitable for various applications.

Voice Selection Best Practices

Match Voice to Content

Choose voices that match your content type:
  • Educational Content: Clear, articulate voices
  • Entertainment: Expressive, character voices
  • Business: Professional, authoritative voices
  • Accessibility: Clear, easy-to-understand voices

Consider Your Audience

Select voices appropriate for your target audience:
  • Age: Match voice age to audience age
  • Language: Use native speakers’ preferred accents
  • Culture: Consider cultural preferences
  • Accessibility: Ensure voices are clear and understandable

Test Before Production

Always test voices with sample content:
  1. Generate sample audio with your content
  2. Listen to the output quality
  3. Test with your target audience
  4. Adjust voice parameters as needed

Use Voice Samples

Listen to voice samples before integration:
async function previewVoice(voiceId) {
  const response = await fetch(`https://api.voxnexus.ai/v1/voices/${voiceId}`, {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });
  
  const voice = await response.json();
  if (voice.sample_url) {
    const audio = new Audio(voice.sample_url);
    audio.play();
  }
}

Voice Customization

Speed Control

Adjust speech rate to match your needs:
{
  "text": "Hello, world!",
  "voice_id": "vl-xiaoxiao",
  "speed": 1.2
}

Pitch Adjustment

Modify pitch for different effects:
{
  "text": "Hello, world!",
  "voice_id": "vl-xiaoxiao",
  "pitch": 2
}

Volume Control

Adjust volume levels:
{
  "text": "Hello, world!",
  "voice_id": "vl-xiaoxiao",
  "volume": 0.8
}

Multi-Voice Applications

Character Voices

Use different voices for different characters:
const characters = {
  narrator: 'vl-yunxi',
  hero: 'vl-xiaoxiao',
  villain: 'vl-deep-voice'
};

async function narrateStory(story) {
  for (const segment of story.segments) {
    const audio = await synthesize({
      text: segment.text,
      voice_id: characters[segment.character]
    });
    await playAudio(audio);
  }
}

Language Switching

Switch voices based on user language preference:
const voiceMap = {
  'en-US': 'vl-jenny',
  'zh-CN': 'vl-xiaoxiao',
  'es-ES': 'vl-maria'
};

function getVoiceForLanguage(language) {
  return voiceMap[language] || voiceMap['en-US'];
}

Next Steps