Text to Speech › Voices
Voices
Munsit offers a variety of voices with different accents, including Fusha, Emirati, Saudi Najdi, Saudi Hijazi, and more. List them all with one call, then use the voice_id in any text-to-speech request.
1
List voices
GET /api/v1/voices
Retrieve a list of all available voices for text-to-speech synthesis. Requires API key authentication via the x-api-key header. Returns an array of voice objects.
curl -X GET "https://api.munsit.com/api/v1/voices" \ -H "x-api-key: YOUR_API_KEY"
import requestsurl = "https://api.munsit.com/api/v1/voices"headers = { "x-api-key": "YOUR_API_KEY"}response = requests.get(url, headers=headers)voices = response.json()print(voices)
const response = await fetch('https://api.munsit.com/api/v1/voices', { method: 'GET', headers: { 'x-api-key': 'YOUR_API_KEY', },});const voices = await response.json();console.log(voices);
package mainimport ( "encoding/json" "fmt" "net/http" "os")func main() { url := "https://api.munsit.com/api/v1/voices" req, _ := http.NewRequest("GET", url, nil) req.Header.Set("x-api-key", os.Getenv("MUNSIT_API_KEY")) resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() var voices []map[string]any json.NewDecoder(resp.Body).Decode(&voices) fmt.Println(voices)}
2
Response fields
Each voice object contains:
| Field | Type | Description |
|---|---|---|
voice_id | string | Unique identifier for the voice (used in text-to-speech requests) |
name | string | Human-readable name of the voice |
description | string | null | Detailed description of the voice characteristics |
gender | string | null | Gender of the voice (male, female, or null) |
age | string | null | Age category of the voice (middle, elderly, or null) |
languages | array[string] | List of language codes supported by the voice (e.g., ["ar", "en"]) |
dialect | array[string] | List of dialects supported by the voice (e.g., ["fusha", "emirati", "najdi"]) |
type | string | null | Voice type (neural or null) |
sample_url | string | URL to an audio sample of the voice |
Treat
voice_id as an opaque string. A few ids are readable (ar-najdi-male-2), but most of the catalogue looks like PCtWbxjoNTpVQ6gIPaVZ2Hqm. There is no guaranteed ar-{dialect}-{gender}-{n} convention, and readable ids are not enumerable — neighbouring numbers are not guaranteed to exist. Always list voices with GET /voices and use the ids it returns; never construct or pattern-match one.
Custom voices. Some voices may have
null values for certain fields. These are typically custom user-created voices. The voice_id can still be used in text-to-speech requests regardless of these field values.
3
Voice types
Voices can be categorized by dialect, gender (male or female), age (middle or elderly) and languages (supported language codes, e.g. ar for Arabic, en for English).
fushaemiratinajdihijazikuwaitibritish…
fusha is Modern Standard Arabic; najdi and hijazi are the Saudi dialects.
4
Featured voices
Below are the featured Munsit voices available in the text-to-speech API. Each name links to an audio sample.
| Name | Dialect | Language | Sample |
|---|---|---|---|
| Fahad | Najdi | Arabic - English | Listen |
| Lama | Hijazi | Arabic - English | Listen |
| James | American | English - Arabic | Listen |
| Jake | American | Arabic - English | Listen |
| Mansour | Emirati | Arabic - English | Listen |
| Maha | Najdi | Arabic - English | Listen |
| Faisal | Najdi | English - Arabic | Listen |
| Turki | Najdi | Arabic - English | Listen |
| Reem | Najdi | Arabic - English | Listen |
| Mishari | Najdi | Arabic - English | Listen |
| Hala | Najdi | Arabic - English | Listen |
| May | British | English - Arabic | Listen |
| Latifa | Emirati | Arabic - English | Listen |
| Mishal | Najdi | Arabic - English | Listen |
| Maya | American | English - Arabic | Listen |
Explore all voices. View the complete voice library in the dashboard.
5
Using a voice
Use the voice_id from the response in text-to-speech generation endpoints: POST /text-to-speech/:model_id (include voice_id in the request body) or WS /text-to-speech (include voice_id in the WebSocket message). This example uses the faseeh-v1-preview model with the ar-najdi-male-2 voice.
curl -X POST "https://api.munsit.com/api/v1/text-to-speech/faseeh-v1-preview" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "voice_id": "ar-najdi-male-2", "text": "مرحبا بك في فصيح كيف يمكنني مساعدتك اليوم", "stability": 0.5, "speed": 1.0, "streaming": true }' \ --output audio.pcm
import requestsurl = "https://api.munsit.com/api/v1/text-to-speech/faseeh-v1-preview"headers = { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"}data = { "voice_id": "ar-najdi-male-2", "text": "مرحبا بك في فصيح كيف يمكنني مساعدتك اليوم", "stability": 0.5, "speed": 1.0, "streaming": True}response = requests.post(url, json=data, headers=headers, stream=True)with open("audio.pcm", "wb") as f: for chunk in response.iter_content(chunk_size=8192): f.write(chunk)
const response = await fetch('https://api.munsit.com/api/v1/text-to-speech/faseeh-v1-preview', { method: 'POST', headers: { 'x-api-key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ voice_id: 'ar-najdi-male-2', text: 'مرحبا بك في فصيح كيف يمكنني مساعدتك اليوم', stability: 0.5, speed: 1.0, streaming: true, }),});const reader = response.body.getReader();const chunks = [];while (true) { const { done, value } = await reader.read(); if (done) break; chunks.push(value);}
package mainimport ( "bytes" "encoding/json" "io" "net/http" "os")func main() { url := "https://api.munsit.com/api/v1/text-to-speech/faseeh-v1-preview" payload, _ := json.Marshal(map[string]any{ "voice_id": "ar-najdi-male-2", "text": "مرحبا بك في فصيح كيف يمكنني مساعدتك اليوم", "stability": 0.5, "speed": 1.0, "streaming": true, }) req, _ := http.NewRequest("POST", url, bytes.NewReader(payload)) req.Header.Set("x-api-key", os.Getenv("MUNSIT_API_KEY")) req.Header.Set("Content-Type", "application/json") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() out, _ := os.Create("audio.pcm") defer out.Close() io.Copy(out, resp.Body)}
Caching. Voice information doesn't change frequently. Consider caching the voice list to reduce API calls and improve application performance.
6
Go further
SynthesizeUse a voice_id to generate a complete WAV file.POST /text-to-speech/{model_id}
Preview a voiceHear a cloned voice before creating it permanently.POST /voices/preview
Voice cloningCreate a custom voice from your own audio.POST /voices/clone
ModelsChoose the model that pairs with your voice.GET /models
Working with an AI assistant? Every page is available as Markdown: add .md to the URL, or send an Accept: text/markdown header. For the whole documentation in one request, point it at llms-full.txt; the page index is llms.txt. Or use Copy Page, top right.