Skip to main content
GET
/
v1
/
characters
curl --location 'https://v3.mayaresearch.ai/v1/characters' \
--header 'X-API-Key: maya_YOUR_API_KEY_HERE'

[
  {
    "voice_id": "Ava",
    "name": "Ava",
    "description": "Realistic female voice in the 20s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Chloe",
    "name": "Chloe",
    "description": "Realistic female voice in the 20s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Liam",
    "name": "Liam",
    "description": "Realistic male voice in the 20s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Noah",
    "name": "Noah",
    "description": "Realistic male voice in the 20s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "James",
    "name": "James",
    "description": "Realistic male voice in the 40s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Emma",
    "name": "Emma",
    "description": "Realistic female voice in the 40s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Sophie",
    "name": "Sophie",
    "description": "Realistic female voice in the 40s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Oliver",
    "name": "Oliver",
    "description": "Realistic male voice in the 40s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  }
]
This endpoint returns a list of all available pre-designed voice characters. Each character has been optimized for specific use cases and provides consistent, high-quality voice output.
​
X-API-Key
string
required
API key for authentication

​
Response

Returns an array of voice objects.
​
voice_id
string
Unique identifier for the voice (e.g., “Ava”, “Emma”, “Noah”)
​
name
string
Display name of the voice
​
description
string
Detailed description of the voice characteristics
curl --location 'https://v3.mayaresearch.ai/v1/characters' \
--header 'X-API-Key: maya_YOUR_API_KEY_HERE'

[
  {
    "voice_id": "Ava",
    "name": "Ava",
    "description": "Realistic female voice in the 20s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Chloe",
    "name": "Chloe",
    "description": "Realistic female voice in the 20s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Liam",
    "name": "Liam",
    "description": "Realistic male voice in the 20s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Noah",
    "name": "Noah",
    "description": "Realistic male voice in the 20s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "James",
    "name": "James",
    "description": "Realistic male voice in the 40s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Emma",
    "name": "Emma",
    "description": "Realistic female voice in the 40s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Sophie",
    "name": "Sophie",
    "description": "Realistic female voice in the 40s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  },
  {
    "voice_id": "Oliver",
    "name": "Oliver",
    "description": "Realistic male voice in the 40s age with a british accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"
  }
]

​
Using Character Data

Once you retrieve the character list, you can use the voice_id to generate speech: 
curl --location 'https://v3.mayaresearch.ai/v1/tts/generate' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: maya_YOUR_API_KEY_HERE' \
--data '{
  "voice_id": "Ava",
  "text": "Welcome back to another episode of our podcast! Today we are diving into an absolutely fascinating topic.",
  "stream": false
}'

​
Character Selection Tips

Look for characters with:
  • Friendly, approachable descriptions
  • Clear, professional tone
  • Neutral or warm characteristics
  • “customer_service” or “assistant” in use_cases
Look for characters with:
  • Conversational, engaging style
  • Appropriate age and accent for your audience
  • “podcast”, “presenter”, or “host” in use_cases
  • Natural, expressive delivery
Look for characters with:
  • Clear, consistent delivery
  • Appropriate tone for your content
  • “audiobook” or “narration” in use_cases
  • Good range for character voices
Look for characters with:
  • Authoritative, confident tone
  • Professional, polished delivery
  • “professional”, “presentation”, or “formal” in use_cases
  • Clear articulation

​
Error Codes

CodeDescriptionResolution
401Authentication failedVerify your API key is correct
403Access deniedCheck API permissions
500Internal server errorContact support if persistent
Cache the character list in your application to reduce API calls and improve performance.

Authorizations

​
X-API-Key
string
header
required

API key for Maya1 API authentication

Response

Successfully retrieved voices

​
voice_id
string
Example:

"Ava"

​
name
string
Example:

"Ava"

​
description
string
Example:

"Realistic female voice in the 20s age with a american accent. Normal pitch, warm timbre, conversational pacing, energetic tone delivery at medium intensity, podcast Domain, podcast_host role, casual delivery"

⌘I