Skip to main content
This guide outlines the recommended practices to ensure accurate processing, improved quality, and consistent TTS output across all use cases.

Language & Script Guidelines

Multi-Language Code-Mixing

Vox-v1 natively supports seamless code-mixing between English and 12 Indic languages—all in their native scripts. Rules:
  • English → Latin script
  • Indic languages → Native script only

Supported Languages & Examples

LanguageScriptExample
HindiDevanagari”आपका payment अभी तक नहीं आया, please check करें”
TamilTamil”நேத்து call பண்ணேன், but you didn’t pick up”
TeluguTelugu”మీ order இன்னும் ship అవ్వలేదు, tomorrow expect చేయండి”
KannadaKannada”ನಿಮ್ಮ account ಲಿ balance ಇಲ್ಲ, please recharge ಮಾಡಿ”
MalayalamMalayalam”ഞാൻ already message അയച്ചു, didn’t you see it?”
BengaliBengali”আপনার bill টা due হয়ে গেছে, please pay করুন”
GujaratiGujarati”તમારું appointment આવતીકાલે છે, please confirm કરો”
MarathiDevanagari”तुमचा OTP expire झाला, resend करा please”
PunjabiGurmukhi”ਤੁਹਾਡੀ delivery ਅੱਜ ਆ ਜਾਵੇਗੀ, be available please”
OdiaOdia”ଆପଣଙ୍କ request process ହେଉଛି, please wait କରନ୍ତୁ”
AssameseAssamese”আপোনাৰ payment successful হৈছে, thank you!”
UrduPerso-Arabic”آپ کا balance کم ہے، please recharge کریں”

Complex Multi-Script Example

A single sentence mixing multiple languages:
நேத்து call பண்ணினா, ਉਹने pick ही नहीं ਕੀਤਾ, பின்னெ ഞാൻ വെറുതെ കാത്തിരുന്നു!
(Tamil + English + Punjabi + Hindi + Malayalam — all native scripts)

Why Native Scripts Matter

  • ✅ Accurate pronunciation & intonation
  • ✅ Proper syllable stress
  • ✅ Natural-sounding speech

Handling Numbers

Order IDs & Large Numbers

  • Send as separate requests
✅ "Your order id is one two three four five six seven eight nine zero"
❌ "Your order id is 1234567890"

Phone Numbers

Default reading: 3-4-3 pattern
9876543210 → "987-6543-210"

Custom Reading

✅ "double nine triple eight double seven double six"
❌ "9988877766"

Date & Time Formatting

Accepted Date Formats

12/02/2025 → twelve, two, twenty twenty-five
12-02-2025 → twelve, two, twenty twenty-five
Incorrect
31/12/2002 
30-06-24  
21st of June, 2003  
12.02.2025  

Time Formats

14:30 → fourteen thirty
14:30:15 → fourteen thirty fifteen
Incorrect
14:30
14.30  
7'5 AM  

Mathematical Expressions

Always write in full words:
✅ two plus three equals five  
❌ 2+3=5  

✅ five multiplied by three equals fifteen  
❌ 5x3=15  

✅ square root of sixteen equals four  
❌ √16=4  

Approximate Values

✅ approximately twenty minutes  
❌ ~20 mins  

✅ around 500 people attended  
❌ ~500 people attended  

Units & Measurements

✅ five kilometers  
❌ 5km  

✅ twenty kilograms of rice  
❌ 20kg  

✅ thirty degrees Celsius  
❌ 30°C  

✅ 5 feet 6 inches tall  
❌ 5'6"  

Symbols & Special Characters

Spell out all special characters:
. → dot  
@ → at  
_ → underscore  
- → dash  
/ → forward slash  
# → hashtag  
& → and  

Digital Content Formatting

URLs

✅ visit docs dot example dot com forward slash guide  
❌ docs.example.com/guide  

Email

✅ support dot company at gmail dot com  
❌ support.company@gmail.com  

Social Media

✅ at company underscore name  
❌ @company_name  

✅ hashtag trending now  
❌ #TrendingNow  

Range & Interval Notation

✅ five to eight days  
❌ 5-8 days  

✅ between ten and fifteen minutes  
❌ 10-15 minutes  

❌ temperatures 20-30°  

Notes

  • Consistency is critical
  • Write in full words whenever possible
  • Break complex URLs or numbers into smaller chunks
  • Avoid symbols that may have multiple interpretations