TTS

Turn text into spoken audio. Send a language name such as English, then save the WAV body to a file.

Request fields

Field	Type	Default	Description
`text`	string	Required	Nonempty text to convert to audio
`language`	string	Required	A supported language name such as `English`, or the matching lowercase slug
`voice`	string	Omitted	An optional supported voice
`stream`	boolean	`false`	Send audio progressively when `true`

Voices

Omit voice to use the default. Every supported TTS language accepts male and female.

Regional English accents

When language is english, you can also send these regional accent voices:

nigerian_male and nigerian_female
ghanaian_male and ghanaian_female
east_african_male and east_african_female
north_african_male and north_african_female
south_african_male and south_african_female

Example:

{"text": "Good morning.", "language": "english", "voice": "ghanaian_female"}

English speakers for every language

Each of the 37 African languages also has an English voice named {language}_{gender}_speaker. These speak English with that language's native speaker accent. Example:

{"text": "Good morning.", "language": "english", "voice": "igbo_male_speaker"}

Ten speaker ids are the same clips as the regional accents above: igbo_male_speaker = nigerian_male, yoruba_female_speaker = nigerian_female, twi_*_speaker = the Ghanaian pair, swahili_*_speaker = the East African pair, xhosa_*_speaker = the South African pair, and arabic_*_speaker = the North African pair.

Region	Language	Male	Female
West Africa	Igbo	`igbo_male_speaker`	`igbo_female_speaker`
West Africa	Yoruba	`yoruba_male_speaker`	`yoruba_female_speaker`
West Africa	Hausa	`hausa_male_speaker`	`hausa_female_speaker`
West Africa	Twi	`twi_male_speaker`	`twi_female_speaker`
West Africa	Kanuri	`kanuri_male_speaker`	`kanuri_female_speaker`
West Africa	Fula	`fula_male_speaker`	`fula_female_speaker`
West Africa	Ewe	`ewe_male_speaker`	`ewe_female_speaker`
West Africa	Fon	`fon_male_speaker`	`fon_female_speaker`
West Africa	Bambara	`bambara_male_speaker`	`bambara_female_speaker`
West Africa	Wolof	`wolof_male_speaker`	`wolof_female_speaker`
West Africa	Krio	`krio_male_speaker`	`krio_female_speaker`
East Africa	Swahili	`swahili_male_speaker`	`swahili_female_speaker`
East Africa	Kikuyu	`kikuyu_male_speaker`	`kikuyu_female_speaker`
East Africa	Luganda	`luganda_male_speaker`	`luganda_female_speaker`
East Africa	Kinyarwanda	`kinyarwanda_male_speaker`	`kinyarwanda_female_speaker`
East Africa	Amharic	`amharic_male_speaker`	`amharic_female_speaker`
East Africa	Oromo	`oromo_male_speaker`	`oromo_female_speaker`
East Africa	Tigrinya	`tigrinya_male_speaker`	`tigrinya_female_speaker`
East Africa	Somali	`somali_male_speaker`	`somali_female_speaker`
East Africa	Malagasy	`malagasy_male_speaker`	`malagasy_female_speaker`
Southern Africa	Xhosa	`xhosa_male_speaker`	`xhosa_female_speaker`
Southern Africa	Zulu	`zulu_male_speaker`	`zulu_female_speaker`
Southern Africa	Afrikaans	`afrikaans_male_speaker`	`afrikaans_female_speaker`
Southern Africa	Tswana	`tswana_male_speaker`	`tswana_female_speaker`
Southern Africa	Sesotho	`sesotho_male_speaker`	`sesotho_female_speaker`
Southern Africa	Sepedi	`sepedi_male_speaker`	`sepedi_female_speaker`
Southern Africa	Venda	`venda_male_speaker`	`venda_female_speaker`
Southern Africa	Swati	`swati_male_speaker`	`swati_female_speaker`
Southern Africa	Shona	`shona_male_speaker`	`shona_female_speaker`
Southern Africa	Chichewa	`chichewa_male_speaker`	`chichewa_female_speaker`
Southern Africa	Tsonga	`tsonga_male_speaker`	`tsonga_female_speaker`
Southern Africa	Ndebele	`ndebele_male_speaker`	`ndebele_female_speaker`
Southern Africa	Bemba	`bemba_male_speaker`	`bemba_female_speaker`
Southern Africa	Umbundu	`umbundu_male_speaker`	`umbundu_female_speaker`
Central Africa	Lingala	`lingala_male_speaker`	`lingala_female_speaker`
North Africa	Arabic	`arabic_male_speaker`	`arabic_female_speaker`
North Africa	Berber	`berber_male_speaker`	`berber_female_speaker`

Unsupported voice values return invalid_request.

Response

A successful response contains binary WAV audio with Content-Type: audio/wav. Save the response body directly to a .wav file; it is not JSON or base64.

When stream is true, audio bytes arrive progressively. Some audio players require the complete file before playback.

Supported languages

Send the full language name in the language field, such as English or Swahili. Matching lowercase slugs are listed below.

Language	Slug	Language	Slug
Afrikaans	`afrikaans`	Amharic	`amharic`
Arabic	`arabic`	Bambara	`bambara`
Bemba	`bemba`	Berber	`berber`
Chichewa	`chichewa`	English	`english`
Ewe	`ewe`	Fon	`fon`
Fula	`fula`	Hausa	`hausa`
Igbo	`igbo`	Kanuri	`kanuri`
Kikuyu	`kikuyu`	Kinyarwanda	`kinyarwanda`
Krio	`krio`	Lingala	`lingala`
Luganda	`luganda`	Malagasy	`malagasy`
Ndebele	`ndebele`	Oromo	`oromo`
Sepedi	`sepedi`	Sesotho	`sesotho`
Shona	`shona`	Somali	`somali`
Swahili	`swahili`	Swati	`swati`
Tigrinya	`tigrinya`	Tsonga	`tsonga`
Tswana	`tswana`	Twi	`twi`
Umbundu	`umbundu`	Venda	`venda`
Wolof	`wolof`	Xhosa	`xhosa`
Yoruba	`yoruba`	Zulu	`zulu`

Common aliases such as fulani, kiswahili, and tamazight are accepted.

Errors and billing

Before audio begins, failures use the shared JSON error format. If a streamed response is interrupted, treat the audio file as incomplete. TTS is billed according to input text length at $0.10 per 1K characters ($100 per 1M) — see Pricing. Retrying creates a new billable request.

Request example