MondialMondial AI Docs

Voice Management

Manage public and custom voices for TTS generation.

Voice Management

Manage public voices and create custom voices for personalized TTS generation.

Public Voices

List Public Voices

curl -X GET https://api.mondialspeech.com/api/v1/voices/public \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Response

[
  {
    "id": "voice-guid-1",
    "name": "Sarah",
    "description": "Clear female voice",
    "language": "en",
    "gender": "female",
    "age": "adult"
  },
  {
    "id": "voice-guid-2", 
    "name": "David",
    "description": "Professional male voice",
    "language": "en",
    "gender": "male",
    "age": "adult"
  }
]

Custom Voices

List My Voices

curl -X GET https://api.mondialspeech.com/api/v1/voices/my \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Get Specific Voice

curl -X GET https://api.mondialspeech.com/api/v1/voices/{id} \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Create Custom Voice

curl -X POST https://api.mondialspeech.com/api/v1/voices \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: multipart/form-data" \
  -F "name=Persian Female" \
  -F "description=Warm and clear voice" \
  -F "audioSample=@voice_seed.wav"

Custom Voice Requirements

Audio Sample Requirements

  • Format: WAV, MP3, M4A
  • Duration: 10-60 seconds
  • Quality: Clear, no background noise
  • Content: Natural speech, single speaker
  • Language: Match target language

Best Practices for Audio Samples

  1. Clear pronunciation of words
  2. Consistent volume throughout
  3. No background music or noise
  4. Natural speaking pace
  5. Good microphone quality

Voice Categories

By Language

  • English: Multiple accents and styles
  • Persian: Native speakers
  • Arabic: Various dialects
  • Spanish: Latin American and European
  • French: Metropolitan and Canadian
  • German: Standard and regional
  • Italian: Northern and Southern
  • Portuguese: Brazilian and European

By Gender & Age

  • Female: Young, Adult, Mature
  • Male: Young, Adult, Mature
  • Neutral: Gender-neutral voices

By Style

  • Professional: Business and corporate
  • Casual: Friendly and conversational
  • Narrative: Storytelling and audiobooks
  • Educational: Clear and instructional

Using Voices in TTS

curl -X POST https://api.mondialspeech.com/api/v1/media/tts \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello world","voiceId":"voice-guid-1","speed":"Fast"}'

Error Handling

404 Not Found

{ "error": "Voice not found" }

400 Bad Request (Invalid Audio)

{ "error": "Invalid audio file format" }

413 Payload Too Large

{ "error": "Audio file too large" }

Voice Testing

Test Custom Voice

  1. Create voice with high-quality sample
  2. Generate test TTS with short text
  3. Evaluate quality and clarity
  4. Adjust sample if needed

Quality Checklist

  • Clear pronunciation
  • Consistent tone
  • Natural rhythm
  • No artifacts
  • Appropriate emotion