> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timepay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Text to Speech — Best Practices

> Learn best practices for formatting text for optimal audio generation using TimePay AI.

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**

| Language  | Script       | Example                                                  |
| --------- | ------------ | -------------------------------------------------------- |
| Hindi     | Devanagari   | "आपका payment अभी तक नहीं आया, please check करें"        |
| Tamil     | Tamil        | "நேத்து call பண்ணேன், but you didn't pick up"            |
| Telugu    | Telugu       | "మీ order இன்னும் ship అవ్వలేదు, tomorrow expect చేయండి" |
| Kannada   | Kannada      | "ನಿಮ್ಮ account ಲಿ balance ಇಲ್ಲ, please recharge ಮಾಡಿ"    |
| Malayalam | Malayalam    | "ഞാൻ already message അയച്ചു, didn't you see it?"         |
| Bengali   | Bengali      | "আপনার bill টা due হয়ে গেছে, please pay করুন"           |
| Gujarati  | Gujarati     | "તમારું appointment આવતીકાલે છે, please confirm કરો"     |
| Marathi   | Devanagari   | "तुमचा OTP expire झाला, resend करा please"               |
| Punjabi   | Gurmukhi     | "ਤੁਹਾਡੀ delivery ਅੱਜ ਆ ਜਾਵੇਗੀ, be available please"      |
| Odia      | Odia         | "ଆପଣଙ୍କ request process ହେଉଛି, please wait କରନ୍ତୁ"       |
| Assamese  | Assamese     | "আপোনাৰ payment successful হৈছে, thank you!"             |
| Urdu      | Perso-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