Introduction
The AudLabs API gives developers programmatic access to 190+ professional AI voices. Generate natural-sounding speech for any application with a simple REST API, no complex setup required.
Authentication
All API requests require your API key passed as a request header. Get your key from the Developer Portal.
x-api-key: aud_your_api_key_here
// Or as a Bearer token:
Authorization: Bearer aud_your_api_key_hereBase URL
All endpoints below are relative to this URL.
https://app.audlabs.io/api/v1
Rate limits
Every request is checked against these limits. When one is reached the API returns 429 (or 402 when monthly credits run out).
| Limit | Starter | Growth | Pro | Resets |
|---|---|---|---|---|
| Requests | 5 / minute | 5 / minute | 5 / minute | Every minute |
| Monthly credits | 3,000,000 | 10,000,000 | 20,000,000 | 1st of each month |
| Weekly characters | 750,000 | 2,500,000 | 5,000,000 | Monday, 1:00 AM WAT |
| 5-hour window | 150,000 | 500,000 | 1,000,000 | 5 hours after the window starts |
Weekly and 5-hour limit errors include a resetAt time in the response body.
Generate voice
/api/v1/generateConvert text to speech. Returns an MP3 audio file as binary data.
Request body
| Parameter | Description | |
|---|---|---|
text | required | The text to convert to speech. Maximum 50,000 characters per request. |
voice_id | required | The voice to use. See Voice IDs. |
speed | optional | Speech speed. Range: 0.5 to 2.0. Default: 1.0 |
pitch | optional | Pitch adjustment. Range: -12 to 12. Default: 0 |
volume | optional | Volume level. Range: 0.1 to 2.0. Default: 1.0 |
format | optional | Output format. Options: mp3, wav. Default: mp3 |
Example
const response = await fetch('https://app.audlabs.io/api/v1/generate', { method: 'POST', headers: { 'x-api-key': 'aud_your_api_key_here', 'Content-Type': 'application/json' }, body: JSON.stringify({ text: 'Hello world. This is a test of the AudLabs API.', voice_id: 'English_CaptivatingStoryteller', speed: 1.0, format: 'mp3' }) }); const audioBlob = await response.blob(); const audioUrl = URL.createObjectURL(audioBlob); const audio = new Audio(audioUrl); audio.play();
import requests response = requests.post( 'https://app.audlabs.io/api/v1/generate', headers={ 'x-api-key': 'aud_your_api_key_here', 'Content-Type': 'application/json' }, json={ 'text': 'Hello world. This is a test of the AudLabs API.', 'voice_id': 'English_CaptivatingStoryteller', 'speed': 1.0 } ) with open('output.mp3', 'wb') as f: f.write(response.content)
curl -X POST https://app.audlabs.io/api/v1/generate \ -H "x-api-key: aud_your_api_key_here" \ -H "Content-Type: application/json" \ -d '{"text":"Hello world. This is a test of the AudLabs API.","voice_id":"English_CaptivatingStoryteller","speed":1.0}' \ --output output.mp3
Response headers
| Header | Description |
|---|---|
Content-Type | audio/mpeg for MP3, audio/wav for WAV |
X-Characters-Used | Number of characters consumed by this request |
X-Credits-Remaining | Your remaining monthly credit balance |
List voices
/api/v1/voicesReturns a list of all available voices with their IDs and metadata.
const response = await fetch('https://app.audlabs.io/api/v1/voices', { headers: { 'x-api-key': 'aud_your_api_key_here' } }); const data = await response.json(); console.log(data.voices);
curl https://app.audlabs.io/api/v1/voices \
-H "x-api-key: aud_your_api_key_here"{
"voices": [
{ "id": "English_CaptivatingStoryteller", "name": "Booker", "language": "English", "gender": "male" },
...
],
"total": 192
}Check balance
/api/v1/balanceReturns your current monthly credit balance and usage statistics.
{
"success": true,
"credits": 4850000,
"totalCharacters": 150000,
"plan": "growth"
}curl https://app.audlabs.io/api/v1/balance \
-H "x-api-key: aud_your_api_key_here"Voice IDs
Use these IDs as voice_id in your generate requests. All 192 voices are available on all plans. Click an ID to copy it.
| Voice ID | Name | Language | Gender |
|---|---|---|---|
English_CaptivatingStoryteller | Booker | English | Male |
English_Trustworth_Man | Allan | English | Male |
English_Gentle-voiced_man | John | English | Male |
English_MatureBoss | Edna | English | Female |
English_CalmWoman | Gallegos | English | Female |
English_captivating_female1 | Myrtle | English | Female |
English_Friendly_Female_3 | Deana | English | Female |
English_engaging_instructor_vv2 | Driskill | English | Male |
English_expressive_host__vv1 | Maddox | English | Male |
English_causual_podcast_vv1 | Evans | English | Male |
Eglish_horror_movie_narrator_vv1 | Jerry | English | Male |
English_Aussie_Bloke | Aussie Bloke | English | Male |
English_radiant_girl | Andrea | English | Female |
English_Upbeat_Woman | Priscilla | English | Female |
English_nursery_teacher_vv2 | Faith | English | Female |
English_instructive_professor_vv1 | Helen | English | Female |
movie_trailer_deep | Austin | English | Male |
English_Insightful_Speaker | Alfred | English | Male |
English_Lively_Male_11 | William | English | Male |
English_FriendlyPerson | Aaron | English | Male |
English_Steady_Female_1 | Lillian | English | Female |
socialmedia_female_1_v1 | Eleanor | English | Female |
moss_audio_3efb9e96-6e80-11f1-b3de-deb486b97a4e | Brian | English | Male |
moss_audio_cedfd4d2-736d-11f0-99be-fe40dd2a5fe8 | Shell | English | Male |
moss_audio_00b1d233-6182-11f1-88bd-f6b1c9bf6181 | Jackson | English | Male |
moss_audio_c7f7edbb-6e87-11f1-8fdf-22f27a8feaff | Adam | English | Male |
moss_audio_6dc281eb-713c-11f0-a447-9613c873494c | Diana | English | Female |
moss_audio_076697ad-7144-11f0-a447-9613c873494c | Joel | English | Male |
moss_audio_7c7e7ae2-7356-11f0-9540-7ef9b4b62566 | Celia | English | Female |
moss_audio_62ca20b0-7380-11f0-99be-fe40dd2a5fe8 | Nancy | English | Female |
Afrikaans_male_1_v1 | Pieter | Afrikaans | Male |
Afrikaans_female_1_v1 | Annelie | Afrikaans | Female |
German_FriendlyMan | Felix | German | Male |
German_PlayfulMan | Leon | German | Male |
German_SweetLady | Sophie | German | Female |
Italian_Narrator | Lorenzo | Italian | Male |
Italian_ReliableMan | Matteo | Italian | Male |
Italian_AthleticStudent | Marco | Italian | Male |
Italian_BraveHeroine | Valentina | Italian | Female |
Italian_WanderingSorcerer | Elena | Italian | Female |
Italian_DiligentLeader | Lucia | Italian | Female |
Italian_ArrogantPrincess | Bianca | Italian | Female |
Russian_Engaging_Historian_v1 | Alexander | Russian | Male |
Russian_Philosophical_Narrator_v1 | Ivan | Russian | Male |
Russian_Overwhelmed_Vlogger_v1 | Mikhail | Russian | Male |
Russian_Articulate_Tutor_v1 | Sergei | Russian | Male |
Russian_Thoughtful_Analyst_v1 | Andrei | Russian | Male |
Russian_Theatrical_Narrator_v1 | Alexei | Russian | Male |
Russian_Heroic_Warrior_v1 | Pavel | Russian | Male |
Russian_Professional_Broadcaster_v2 | Yuri | Russian | Male |
Russian_Rugged_Storyteller_v1 | Viktor | Russian | Male |
Russian_Serious_Journalist_v3 | Oleg | Russian | Male |
Russian_Energetic_Streamer_v1 | Igor | Russian | Male |
Russian_HandsomeChildhoodFriend | Artem | Russian | Male |
Russian_ReliableMan | Roman | Russian | Male |
Russian_AttractiveGuy | Denis | Russian | Male |
Russian_Bad-temperedBoy | Vladimir | Russian | Male |
Russian_Energetic_Boy_v2 | Nikolai | Russian | Male |
Russian_Gentle_Storyteller_v3 | Maria | Russian | Female |
Russian_Dramatic_Speaker_v1 | Anna | Russian | Female |
Russian_Engaging_Podcaster_v1 | Irina | Russian | Female |
Russian_Spirited_Narrator_v1 | Yulia | Russian | Female |
Russian_Energetic_Tutor_v1 | Alina | Russian | Female |
Russian_Wise_Mentor_v1 | Vera | Russian | Female |
Russian_Energetic_Reporter_v2 | Daria | Russian | Female |
Russian_Spirited_Schoolgirl_v1 | Olga | Russian | Female |
Russian_BrightHeroine | Ludmila | Russian | Female |
Russian_AmbitiousWoman | Natalia | Russian | Female |
Russian_CrazyQueen | Valeria | Russian | Female |
Russian_PessimisticGirl | Vera II | Russian | Female |
Ukrainian_WiseScholar | Taras | Ukrainian | Male |
Ukrainian_CalmWoman | Vika | Ukrainian | Female |
French_Male_Speech_New | Level-Headed Man | French | Male |
French_CasualMan | Casual Man | French | Male |
French_MaleNarrator | Male Narrator | French | Male |
French_Female_News Anchor | Patient Female Presenter | French | Female |
French_MovieLeadFemale | Movie Lead Female | French | Female |
French_FemaleAnchor | Female Anchor | French | Female |
French_Female Journalist | Fluent Female | French | Female |
French_Female_Speech_New | Persuasive Female | French | Female |
Spanish_MaturePartner | Mature Partner | Spanish | Male |
Spanish_CaptivatingStoryteller | Captivating Storyteller | Spanish | Male |
Spanish_BossyLeader | Bossy Leader | Spanish | Male |
Spanish_RationalMan | Rational Man | Spanish | Male |
Spanish_Deep-tonedMan | Deep-toned Man | Spanish | Male |
Spanish_DeterminedManager | Determined Manager | Spanish | Female |
Spanish_SophisticatedLady | Sophisticated Lady | Spanish | Female |
Spanish_Fussyhostess | Fussy Hostess | Spanish | Female |
Spanish_FrankLady | Frank Lady | Spanish | Female |
Spanish_ToughBoss | Tough Boss | Spanish | Female |
Portuguese_BR_Engaging_Historian_v1 | Gabriel | Portuguese | Male |
Portuguese_BR_Philosophical_Narrator_v1 | Rafael | Portuguese | Male |
Portuguese_BR_Overwhelmed_Vlogger_v1 | Lucas | Portuguese | Male |
Portuguese_BR_Articulate_Tutor_v1 | Mateus | Portuguese | Male |
Portuguese_BR_Thoughtful_Analyst_v1 | Pedro | Portuguese | Male |
Portuguese_BR_Theatrical_Narrator_v1 | Henrique | Portuguese | Male |
Portuguese_BR_Heroic_Warrior_v1 | Eduardo | Portuguese | Male |
Portuguese_BR_Professional_Broadcaster_v2 | Bruno | Portuguese | Male |
Portuguese_BR_Rugged_Storyteller_v1 | Thiago | Portuguese | Male |
Portuguese_BR_Serious_Journalist_v3 | Gustavo | Portuguese | Male |
Portuguese_BR_Energetic_Streamer_v1 | Felipe | Portuguese | Male |
Portuguese_BR_Gentle_Storyteller_v3 | Diego | Portuguese | Male |
Portuguese_BR_Dramatic_Speaker_v1 | Vinicius | Portuguese | Male |
Portuguese_BR_Engaging_Podcaster_v1 | Rodrigo | Portuguese | Male |
Portuguese_BR_Spirited_Narrator_v1 | Caio | Portuguese | Male |
Portuguese_BR_Energetic_Tutor_v1 | Leandro | Portuguese | Male |
Portuguese_BR_Wise_Mentor_v1 | Marcelo | Portuguese | Male |
Portuguese_BR_Energetic_Reporter_v2 | Andre | Portuguese | Male |
Portuguese_BR_Spirited_Schoolgirl_v1 | Fabio | Portuguese | Male |
Portuguese_BR_Engaging_Historian_v2 | Renato | Portuguese | Male |
Portuguese_BR_Philosophical_Narrator_v2 | Sergio | Portuguese | Male |
Portuguese_BR_Overwhelmed_Vlogger_v2 | Marcos | Portuguese | Male |
Portuguese_BR_Articulate_Tutor_v2 | Leonardo | Portuguese | Male |
Portuguese_BR_Thoughtful_Analyst_v2 | Alexandre | Portuguese | Male |
Portuguese_BR_Theatrical_Narrator_v2 | Antonio | Portuguese | Male |
Portuguese_BR_Heroic_Warrior_v2 | Carlos | Portuguese | Male |
Portuguese_BR_Professional_Broadcaster_v3 | Daniel | Portuguese | Male |
Portuguese_BR_Rugged_Storyteller_v2 | Fernando | Portuguese | Male |
Portuguese_BR_Serious_Journalist_v4 | Jose | Portuguese | Male |
Portuguese_BR_Energetic_Streamer_v2 | Paulo | Portuguese | Male |
Portuguese_BR_Gentle_Storyteller_v4 | Roberto | Portuguese | Male |
Portuguese_BR_Dramatic_Speaker_v2 | Ricardo | Portuguese | Male |
Portuguese_BR_Engaging_Podcaster_v2 | Victor | Portuguese | Male |
Portuguese_BR_Spirited_Narrator_v2 | Wanderson | Portuguese | Male |
Portuguese_BR_Energetic_Tutor_v2 | Guilherme | Portuguese | Male |
Portuguese_BR_Wise_Mentor_v2 | Claudio | Portuguese | Male |
Portuguese_BR_Energetic_Reporter_v3 | Cristiano | Portuguese | Male |
Portuguese_BR_Spirited_Schoolgirl_v2 | Danilo | Portuguese | Male |
Portuguese_BR_Engaging_Historian_v3 | Edilson | Portuguese | Male |
Portuguese_BR_Philosophical_Narrator_v3 | Emerson | Portuguese | Male |
Portuguese_BR_Overwhelmed_Vlogger_v3 | Evandro | Portuguese | Male |
Portuguese_BR_Articulate_Tutor_v3 | Flavio | Portuguese | Male |
Portuguese_BR_Thoughtful_Analyst_v3 | Geovani | Portuguese | Male |
Portuguese_BR_Theatrical_Narrator_v3 | Gilberto | Portuguese | Male |
Portuguese_BR_Heroic_Warrior_v3 | Heitor | Portuguese | Male |
Portuguese_BR_Professional_Broadcaster_v4 | Hugo | Portuguese | Male |
Portuguese_BR_Rugged_Storyteller_v3 | Iago | Portuguese | Male |
Portuguese_BR_Serious_Journalist_v5 | Icaro | Portuguese | Male |
Portuguese_BR_Energetic_Streamer_v3 | Italo | Portuguese | Male |
Portuguese_BR_Gentle_Storyteller_v5 | Jadson | Portuguese | Male |
Portuguese_BR_Dramatic_Speaker_v3 | Jairo | Portuguese | Male |
Portuguese_BR_Engaging_Podcaster_v3 | Janio | Portuguese | Male |
Portuguese_BR_Spirited_Narrator_v3 | Jeferson | Portuguese | Male |
Portuguese_BR_Energetic_Tutor_v3 | Jessé | Portuguese | Male |
Portuguese_BR_Female_Gentle_Storyteller_v1 | Ana | Portuguese | Female |
Portuguese_BR_Female_Dramatic_Speaker_v1 | Beatriz | Portuguese | Female |
Portuguese_BR_Female_Engaging_Podcaster_v1 | Camila | Portuguese | Female |
Portuguese_BR_Female_Spirited_Narrator_v1 | Carolina | Portuguese | Female |
Portuguese_BR_Female_Energetic_Tutor_v1 | Fernanda | Portuguese | Female |
Portuguese_BR_Female_Wise_Mentor_v1 | Gabriela | Portuguese | Female |
Portuguese_BR_Female_Energetic_Reporter_v1 | Isabella | Portuguese | Female |
Portuguese_BR_Female_Spirited_Schoolgirl_v1 | Julia | Portuguese | Female |
Portuguese_BR_Female_Engaging_Historian_v1 | Laura | Portuguese | Female |
Portuguese_BR_Female_Philosophical_Narrator_v1 | Leticia | Portuguese | Female |
Portuguese_BR_Female_Overwhelmed_Vlogger_v1 | Livia | Portuguese | Female |
Portuguese_BR_Female_Articulate_Tutor_v1 | Lucia | Portuguese | Female |
Portuguese_BR_Female_Thoughtful_Analyst_v1 | Luisa | Portuguese | Female |
Portuguese_BR_Female_Theatrical_Narrator_v1 | Mariana | Portuguese | Female |
Portuguese_BR_Female_Heroic_Warrior_v1 | Natalia | Portuguese | Female |
Portuguese_BR_Female_Professional_Broadcaster_v1 | Patricia | Portuguese | Female |
Portuguese_BR_Female_Rugged_Storyteller_v1 | Rafaela | Portuguese | Female |
Portuguese_BR_Female_Serious_Journalist_v1 | Renata | Portuguese | Female |
Portuguese_BR_Female_Energetic_Streamer_v1 | Sabrina | Portuguese | Female |
Portuguese_BR_Female_Gentle_Storyteller_v2 | Silvia | Portuguese | Female |
Portuguese_BR_Female_Dramatic_Speaker_v2 | Simone | Portuguese | Female |
Portuguese_BR_Female_Engaging_Podcaster_v2 | Tatiane | Portuguese | Female |
Portuguese_BR_Female_Spirited_Narrator_v2 | Thais | Portuguese | Female |
Portuguese_BR_Female_Energetic_Tutor_v2 | Vanessa | Portuguese | Female |
Portuguese_BR_Female_Wise_Mentor_v2 | Veronica | Portuguese | Female |
Portuguese_BR_Female_Energetic_Reporter_v2 | Viviane | Portuguese | Female |
Portuguese_BR_Female_Spirited_Schoolgirl_v2 | Yasmin | Portuguese | Female |
Portuguese_BR_Female_Engaging_Historian_v2 | Yolanda | Portuguese | Female |
Portuguese_BR_Female_Philosophical_Narrator_v2 | Zuleide | Portuguese | Female |
Portuguese_BR_Female_Overwhelmed_Vlogger_v2 | Adriana | Portuguese | Female |
Portuguese_BR_Female_Articulate_Tutor_v2 | Alessandra | Portuguese | Female |
Portuguese_BR_Female_Thoughtful_Analyst_v2 | Aline | Portuguese | Female |
Portuguese_BR_Female_Theatrical_Narrator_v2 | Amanda | Portuguese | Female |
Portuguese_BR_Female_Heroic_Warrior_v2 | Andreia | Portuguese | Female |
Portuguese_BR_Female_Professional_Broadcaster_v2 | Angela | Portuguese | Female |
Portuguese_BR_Female_Rugged_Storyteller_v2 | Bruna | Portuguese | Female |
Portuguese_BR_Female_Serious_Journalist_v2 | Claudia | Portuguese | Female |
Portuguese_BR_Female_Energetic_Streamer_v2 | Cristina | Portuguese | Female |
Portuguese_BR_Female_Gentle_Storyteller_v3 | Debora | Portuguese | Female |
Portuguese_BR_Female_Dramatic_Speaker_v3 | Denise | Portuguese | Female |
Portuguese_BR_Female_Engaging_Podcaster_v3 | Edilaine | Portuguese | Female |
Portuguese_BR_Female_Spirited_Narrator_v3 | Elaine | Portuguese | Female |
Portuguese_BR_Female_Energetic_Tutor_v3 | Erica | Portuguese | Female |
Portuguese_BR_Female_Wise_Mentor_v3 | Fatima | Portuguese | Female |
Portuguese_BR_Female_Energetic_Reporter_v3 | Flavia | Portuguese | Female |
Portuguese_BR_Female_Spirited_Schoolgirl_v3 | Gislaine | Portuguese | Female |
Portuguese_BR_Female_Engaging_Historian_v3 | Iara | Portuguese | Female |
Portuguese_BR_Female_Philosophical_Narrator_v3 | Ilana | Portuguese | Female |
Error codes
Errors return JSON with an error message, for example {"error": "text is required"}.
| Status | Code | Description |
|---|---|---|
| 400 | Bad Request | Missing required parameters or invalid values in request body. |
| 401 | Unauthorized | Missing or invalid API key. Check your x-api-key header. |
| 402 | Payment Required | No active subscription, subscription expired, or monthly credits exhausted. Subscribe at platform.audlabs.io. |
| 429 | Rate Limited | More than 5 requests per minute, or the weekly or 5-hour limit was reached. Slow down or wait for the reset. |
| 500 | Server Error | Internal error. Contact hello@audlabs.io if this persists. |
| 503 | Service Unavailable | Voice generation temporarily at capacity. Retry after a few seconds. |
Pricing
Plans are bought monthly at platform.audlabs.io. 1 credit = 1 character. Credits expire at the end of each month, and plans do not renew automatically.
Pay by bank transfer (Naira) or card. Need a custom plan or have questions? Email hello@audlabs.io.
Get your API key