Skip to main content
GET
https://api.audixa.ai
/
v2
/
voices
# List Base model voices
curl -X GET "https://api.audixa.ai/v2/voices?model=base" \
  -H "x-api-key: YOUR_API_KEY"

# List Advance model voices
curl -X GET "https://api.audixa.ai/v2/voices?model=advance" \
  -H "x-api-key: YOUR_API_KEY"

{
  "user_id": "user_123abc",
  "model": "base",
  "voices": [
    {
      "voice_id": "aura-asteria-en",
      "name": "Asteria",
      "gender": "female",
      "accent": "American English",
      "description": "Clear, professional female voice"
    },
    {
      "voice_id": "aura-orion-en",
      "name": "Orion",
      "gender": "male",
      "accent": "American English",
      "description": "Deep, authoritative male voice"
    },
    {
      "voice_id": "aura-luna-en",
      "name": "Luna",
      "gender": "female",
      "accent": "British English",
      "description": "Warm, friendly British female voice"
    },
    {
      "voice_id": "aura-atlas-en",
      "name": "Atlas",
      "gender": "male",
      "accent": "British English",
      "description": "Confident British male voice"
    }
  ]
}
Retrieves the catalog of available voices for the specified model. Use the returned voice_id values in your /tts requests.

​
Request

​
model
string
required
The model tier to list voices for. Must be base or advance.

​
Response

​
user_id
string
Your user ID.
​
model
string
The model tier that was queried.
​
voices
array
Array of available voice objects.

​
Examples

# List Base model voices
curl -X GET "https://api.audixa.ai/v2/voices?model=base" \
  -H "x-api-key: YOUR_API_KEY"

# List Advance model voices
curl -X GET "https://api.audixa.ai/v2/voices?model=advance" \
  -H "x-api-key: YOUR_API_KEY"

{
  "user_id": "user_123abc",
  "model": "base",
  "voices": [
    {
      "voice_id": "aura-asteria-en",
      "name": "Asteria",
      "gender": "female",
      "accent": "American English",
      "description": "Clear, professional female voice"
    },
    {
      "voice_id": "aura-orion-en",
      "name": "Orion",
      "gender": "male",
      "accent": "American English",
      "description": "Deep, authoritative male voice"
    },
    {
      "voice_id": "aura-luna-en",
      "name": "Luna",
      "gender": "female",
      "accent": "British English",
      "description": "Warm, friendly British female voice"
    },
    {
      "voice_id": "aura-atlas-en",
      "name": "Atlas",
      "gender": "male",
      "accent": "British English",
      "description": "Confident British male voice"
    }
  ]
}

​
Using Voices

Once you’ve selected a voice, use its voice_id in your TTS request: 
{
  "text": "Hello, this is a test.",
  "voice": "aura-asteria-en",
  "model": "base"
}
Make sure the voice belongs to the model you’re using. Base voices can only be used with model: "base", and Advance voices with model: "advance".

​
Custom Voices (Advance Model)

When querying ?model=advance, you may see custom voices you’ve created: 
{
  "voice_id": "custom_abc123",
  "name": "My Brand Voice",
  "gender": "female",
  "accent": "American English",
  "description": "Cloned voice from uploaded samples",
  "custom": true
}

Create Custom Voices

Clone your own voice in the dashboard.

​
Error Responses

Missing or invalid model parameter.
{
  "detail": "Model parameter is required. Use 'base' or 'advance'."
}
Missing or invalid API key.
{
  "detail": "Invalid or missing API key"
}
Rate limit exceeded.
{
  "detail": "Rate limit exceeded. Please retry after 30 seconds."
}