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
- Clear pronunciation of words
- Consistent volume throughout
- No background music or noise
- Natural speaking pace
- 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
- Create voice with high-quality sample
- Generate test TTS with short text
- Evaluate quality and clarity
- Adjust sample if needed
Quality Checklist
- Clear pronunciation
- Consistent tone
- Natural rhythm
- No artifacts
- Appropriate emotion
