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

# Voices

> Built to sound like Pakistan. 82 native voices — every accent, every walk of life.

## Voice catalog

All voices speak Urdu. Pass any `voiceId` below to the synthesis API. Complete machine-readable data, including sample transcripts, is at [/voices.json](https://docs.upliftai.org/voices.json).

| voiceId                 | Name                  | Description                                                                                    | Urdu accent | Gender | Age    | Tags                                     |
| ----------------------- | --------------------- | ---------------------------------------------------------------------------------------------- | ----------- | ------ | ------ | ---------------------------------------- |
| `jinn`                  | Jinn                  | Ancient watcher carrying millennia of cold philosophical dread.                                | Standard    | Male   | Mythic | Dramatic, Mythic, Horror                 |
| `sindhi-patriarch`      | Sindhi Patriarch      | Deep Sindhi-accented elder. Sufi gravity.                                                      | Sindhi      | Male   | Senior | Character, Devotional, Authoritative     |
| `punjabi-masi`          | Punjabi Masi          | Pragmatic Punjabi-accented young female — warm and earthy.                                     | Punjabi     | Female | Young  | Character, Warm                          |
| `cricket-commentator`   | Cricket Commentator   | Animated commentator calling a high-voltage T20 match — energetic, broadcast-grade.            | Standard    | Female | Young  | Sports, Energetic, Professional          |
| `pashtun-pensioner`     | Pashtun Pensioner     | Dignified Pashtun-accented elder. Warm, weathered tone.                                        | Pashto      | Male   | Senior | Character, Warm                          |
| `crime-don`             | Crime Don             | Dark, menacing Bollywood-style villain.                                                        | Standard    | Male   | Adult  | Dramatic, Character, Villain             |
| `schoolgirl`            | Schoolgirl            | Bright 12-year-old female.                                                                     | Standard    | Female | Child  | Character, Youth, Educational            |
| `bengali-grandfather`   | Bengali Grandfather   | Warm Bengali-accented grandfather — garrulous, nostalgic.                                      | Bengali     | Male   | Senior | Narration, Character, Warm               |
| `churail`               | Churail               | Cold, predatory female.                                                                        | Standard    | Female | Mythic | Dramatic, Horror, Mythic                 |
| `balochi-seamstress`    | Balochi Seamstress    | Balochi-accented young woman — resilient, warm, community-driven delivery.                     | Balochi     | Female | Young  | Character, Community                     |
| `iqbalian-shayar`       | Iqbalian Shayar       | Dramatic Urdu poetry recitation. Bold, passionate cadence.                                     | Standard    | Male   | Adult  | Poetry, Dramatic, Devotional             |
| `late-night-rj`         | Late Night RJ         | Warm late-night female radio host — smooth, intimate tone.                                     | Standard    | Female | Young  | Warm, Entertainment, Professional        |
| `dha-matriarch`         | DHA Matriarch         | English-educated burger-Urdu grande dame — composed authority.                                 | Burger      | Female | Senior | Character, Authoritative                 |
| `bihari-organizer`      | Bihari Organizer      | Bihari-accented young woman — capable, community-driven energy.                                | Bihari      | Female | Young  | Character, Community                     |
| `memon-organizer`       | Memon Organizer       | Memon-accented young woman — warm, quietly capable community voice.                            | Memon       | Female | Young  | Character, Community                     |
| `crisp-storyteller`     | Crisp Storyteller     | Crisp, contemplative male narration.                                                           | Standard    | Male   | Adult  | Narration, Audiobook, Contemplative      |
| `qissa-khawan`          | Qissa Khawan          | Bold, classic male storyteller. Solemn pacing.                                                 | Standard    | Male   | Adult  | Narration, Audiobook, Authoritative      |
| `female-narrator`       | Female Narrator       | Female documentary narrator — clean, balanced delivery.                                        | Standard    | Female | Adult  | Narration, Professional, Documentary     |
| `male-narrator`         | Male Narrator         | Authoritative male documentary narrator.                                                       | Standard    | Male   | Adult  | Narration, Professional, Documentary     |
| `podcast-host`          | Podcast Host          | Reflective male podcast host — measured pace.                                                  | Standard    | Male   | Adult  | Narration, Professional, Contemplative   |
| `horror-narrator`       | Horror Narrator       | Spooky, menacing male voice.                                                                   | Standard    | Male   | Adult  | Dramatic, Horror, Narration              |
| `prime-time-anchor`     | Prime Time Anchor     | Male prime-time news anchor.                                                                   | Standard    | Male   | Adult  | News, Professional, Authoritative        |
| `senior-anchor`         | Senior Anchor         | Clean male anchor — balanced tone, good tempo.                                                 | Standard    | Male   | Senior | News, Authoritative, Professional        |
| `news-anchor`           | News Anchor           | Female anchor — sharp, clean, broadcast-ready delivery.                                        | Standard    | Female | Adult  | News, Professional                       |
| `news-reader`           | News Reader           | Soft female news voice — slightly fast pace.                                                   | Standard    | Female | Young  | News, Professional                       |
| `field-correspondent`   | Field Correspondent   | Energetic male field reporter — sharp, fast-paced.                                             | Standard    | Male   | Young  | News, Energetic, Professional            |
| `paediatrician`         | Paediatrician         | Warm female paediatrician — calm authority.                                                    | Standard    | Female | Adult  | Professional, Medical, Warm              |
| `diabetologist`         | Diabetologist         | Plain-speaking male doctor — calm and educational.                                             | Standard    | Male   | Adult  | Professional, Medical, Educational       |
| `family-lawyer`         | Family Lawyer         | Composed female advocate — authoritative delivery.                                             | Standard    | Female | Adult  | Professional, Authoritative              |
| `defense-advocate`      | Defense Advocate      | Methodical male defense advocate — precise tone.                                               | Standard    | Male   | Adult  | Professional, Authoritative              |
| `navy-officer`          | Navy Officer          | Seasoned commanding officer voice — authoritative, ship-tested delivery.                       | Standard    | Male   | Adult  | Professional, Authoritative              |
| `stock-analyst`         | Stock Analyst         | Composed PSX commodity analyst — measured Urdu.                                                | Standard    | Male   | Adult  | Professional, Educational, Financial     |
| `helpdesk-agent`        | Helpdesk Agent        | Warm female customer service voice — patient, empathetic.                                      | Standard    | Female | Young  | Professional, Customer Service, Warm     |
| `broadband-support`     | Broadband Support     | Polished male telecom support — empathetic, methodical, formal Urdu register.                  | Standard    | Male   | Adult  | Professional, Customer Service           |
| `montessori-teacher`    | Montessori Teacher    | Warm-but-firm female teacher.                                                                  | Standard    | Female | Adult  | Educational, Warm, Professional          |
| `urdu-professor`        | Urdu Professor        | Measured male university lecturer — erudite delivery.                                          | Standard    | Male   | Adult  | Educational, Authoritative, Professional |
| `washroom-singer`       | Washroom Singer       | A gloriously tone-deaf shower singer — every note off-key, yet utterly unable to stop belting. | Standard    | Male   | Adult  | Character, Funny, Warm                   |
| `khateeb`               | Khateeb               | Impassioned male religious orator — Arabic and Urdu in one breath.                             | Standard    | Male   | Adult  | Religious, Dramatic, Public Speaking     |
| `seerah-scholar`        | Seerah Scholar        | Seasoned scholar — methodical, authoritative delivery.                                         | Standard    | Male   | Adult  | Religious, Educational, Authoritative    |
| `hadith-narrator`       | Hadith Narrator       | Female religious teacher — calm scholarly authority.                                           | Standard    | Female | Adult  | Religious, Educational, Authoritative    |
| `seerah-educator`       | Seerah Educator       | Measured male hadith narrator — scholarly warmth and isnad-recitation cadence.                 | Standard    | Male   | Adult  | Religious, Educational                   |
| `dawah-youtuber`        | Dawah YouTuber        | Warm young male dawah voice — hadith and Islamic knowledge in a friendly register.             | Standard    | Male   | Young  | Religious, Educational, Warm             |
| `nosey-aunty`           | Nosey Aunty           | Mohalla broadcaster — chai, gossip, righteous indignation.                                     | Standard    | Female | Adult  | Character, Funny                         |
| `orangi-khala`          | Orangi Khala          | Khandan-proud matriarch — proud, expressive, hearty delivery.                                  | Standard    | Female | Senior | Character, Funny                         |
| `rohtaki-aunty`         | Rohtaki Aunty         | Punjabi-accented rural aunty — sharp wit, comedic timing, hearty delivery.                     | Punjabi     | Female | Adult  | Character, Funny                         |
| `dua-uncle`             | Dua Uncle             | Frail elderly male, plaintive tone.                                                            | Standard    | Male   | Senior | Character, Street                        |
| `bus-conductor`         | Bus Conductor         | Wiry, relentless minibus conductor — energetic shouting.                                       | Standard    | Male   | Young  | Character, Street, Energetic             |
| `lahori-barber`         | Lahori Barber         | Old-city barber running a one-man radio station — comedic, fast-talking.                       | Standard    | Male   | Adult  | Character, Funny, Street                 |
| `shopkeeper`            | Shopkeeper            | Warm kiryana shopkeeper — friendly haggling tone.                                              | Standard    | Male   | Adult  | Character, Street, Warm                  |
| `street-vendor`         | Street Vendor         | Sun-baked thela-wala — sharp-tongued, energetic delivery.                                      | Standard    | Male   | Adult  | Character, Street, Energetic             |
| `traffic-cop`           | Traffic Cop           | Firm authority with dry chacha-style wit.                                                      | Standard    | Male   | Adult  | Character, Funny, Street                 |
| `khwajasara`            | Khwajasara            | Androgynous Pakistani character voice — warm, wry, dignified delivery.                         | Standard    | —      | Adult  | Character, Community, Emotional          |
| `dha-teen-girl`         | DHA Teen Girl         | Burger-Urdu teen girl — dramatic, expressive delivery.                                         | Burger      | Female | Teen   | Character, Funny, Youth                  |
| `dha-fitness-devotee`   | DHA Fitness Devotee   | Self-aware burger-Urdu fitness voice.                                                          | Burger      | Female | Young  | Character, Lifestyle, Funny              |
| `dha-hostess`           | DHA Hostess           | Polished mid-40s burger-Urdu — composed delivery.                                              | Burger      | Female | Adult  | Character, Dramatic                      |
| `nazimabad-boy`         | Nazimabad Boy         | Urdu-medium teen boy — natural delivery.                                                       | Standard    | Male   | Teen   | Character, Youth                         |
| `karachi-romeo`         | Karachi Romeo         | Young male voice — thinks he's a charmer.                                                      | Standard    | Male   | Young  | Character, Funny, Street                 |
| `wholesale-trader`      | Wholesale Trader      | Middle-aged Karachi trader — steady, measured delivery.                                        | Standard    | Male   | Adult  | Character, Professional                  |
| `college-girl`          | College Girl          | Determined Karachi college-aged female — natural, conversational delivery.                     | Standard    | Female | Teen   | Character, Youth                         |
| `gaming-kid`            | Gaming Kid            | Mischievous 8-year-old male — playful delivery.                                                | Standard    | Male   | Child  | Character, Funny, Youth                  |
| `udaas-aashiq`          | Udaas Aashiq          | Subdued young male — pre-tears delivery.                                                       | Standard    | Male   | Young  | Emotional, Vulnerable                    |
| `heartbroken`           | Heartbroken           | Young male voice-note — soft, weary, emotional.                                                | Standard    | Male   | Young  | Emotional, Vulnerable                    |
| `udaas-philosopher`     | Udaas Philosopher     | Slow, drawled male monologue.                                                                  | Standard    | Male   | Young  | Emotional, Funny, Character              |
| `mohalla-storyteller`   | Mohalla Storyteller   | Bihari-accented adult male — corner-shop storyteller cadence.                                  | Bihari      | Male   | Adult  | Narration, Character                     |
| `mohalla-patriarch`     | Mohalla Patriarch     | Bihari-accented elder male — gruff-but-warm authority.                                         | Bihari      | Male   | Senior | Character, Authoritative                 |
| `balochi-elder`         | Balochi Elder         | Balochi-accented elder male — weathered gravity.                                               | Balochi     | Male   | Senior | Character, Authoritative                 |
| `bengali-businesswoman` | Bengali Businesswoman | Bengali-accented young female — quietly driven entrepreneur voice.                             | Bengali     | Female | Young  | Character, Professional                  |
| `punjabi-manager`       | Punjabi Manager       | Punjabi-accented middle-aged male — steady mid-career professional voice.                      | Punjabi     | Male   | Adult  | Character, Professional                  |
| `lahori-story-uncle`    | Lahori Story Uncle    | Late-50s uncle with Punjabi-Urdu accent. Deep voice.                                           | Punjabi     | Male   | Senior | Character, Warm                          |
| `pashtun-teen`          | Pashtun Teen          | Pashtun-accented teen boy — sharp-witted youth delivery.                                       | Pashto      | Male   | Teen   | Character, Youth                         |
| `pashtun-woman`         | Pashtun Woman         | Pashtun-accented young female — pragmatic, community-driven tone.                              | Pashto      | Female | Young  | Character, Community                     |
| `pashtun-navigator`     | Pashtun Navigator     | Pashtun-accented middle-aged male — weathered, steady delivery.                                | Pashto      | Male   | Adult  | Character, Street                        |
| `sindhi-professional`   | Sindhi Professional   | Sindhi-accented young female professional — composed, contemporary delivery.                   | Sindhi      | Female | Young  | Character, Professional                  |
| `sindhi-networker`      | Sindhi Networker      | Sindhi-accented young male — easy, friendly community-networker tone.                          | Sindhi      | Male   | Young  | Character, Community                     |
| `sindhi-navigator`      | Sindhi Navigator      | Sindhi-accented middle-aged male — weary delivery.                                             | Sindhi      | Male   | Adult  | Character, Emotional                     |
| `memon-trader`          | Memon Trader          | Memon-accented middle-aged male — methodical wholesale-trader delivery.                        | Memon       | Male   | Adult  | Character, Professional                  |
| `headmaster`            | Headmaster            | Authoritative middle-aged male — commanding delivery.                                          | Standard    | Male   | Adult  | Authoritative, Character                 |
| `jalsa-mimic`           | Jalsa Mimic           | Passionate jalsa speech cadence.                                                               | Standard    | Male   | Adult  | Funny, Character, Entertainment          |
| `street-vlogger`        | Street Vlogger        | Karachi street vlogger — warm female storytelling with on-the-ground energy.                   | Standard    | Female | Young  | Entertainment, Narration, Warm           |
| `biryani-reviewer`      | Biryani Reviewer      | Energetic male food vlogger — emphatic, hungry delivery.                                       | Standard    | Male   | Young  | Entertainment, Funny, Energetic          |
| `female-debater`        | Female Debater        | Sharp, fast female debate cadence.                                                             | Standard    | Female | Young  | Dramatic, Energetic, Public Speaking     |
| `male-debater`          | Male Debater          | Incisive male debate voice.                                                                    | Standard    | Male   | Young  | Dramatic, Energetic, Public Speaking     |

## Using a voice

Pass the `voiceId` from any card above into a synthesis request.

```javascript theme={null}
await fetch("https://api.upliftai.org/v1/synthesis/text-to-speech", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_api_your_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    voiceId: "jinn",
    text: "میں نے تمہیں پکارا تھا، صدیوں پہلے۔",
    outputFormat: "MP3_22050_128"
  })
})
```

## Earlier voices

These remain available for existing integrations.

| voiceId      | Voice                    |
| ------------ | ------------------------ |
| `v_meklc281` | Urdu — Info/Education V2 |
| `v_8eelc901` | Urdu — Info/Education    |
| `v_30s70t3a` | Urdu — Nostalgic News    |
| `v_yypgzenx` | Urdu — Dada Jee          |
| `v_kwmp7zxt` | Urdu — Gen Z (beta)      |
| `v_sd0kl3m9` | Sindhi — Female          |
| `v_sd6mn4p2` | Sindhi — Male Calm       |
| `v_sd9qr7x5` | Sindhi — Male News       |
| `v_bl0ab8c4` | Balochi — Male           |
| `v_bl1de2f7` | Balochi — Female         |

## Tell us what you're building

Reach us at [founders@upliftai.org](mailto:founders@upliftai.org) — we'd love to help you ship.
