API Documentation

AudLabs API

The AudLabs API gives developers programmatic access to 190+ professional AI voices. Generate natural-sounding speech for any application โ€” simple REST API, no complex setup required.

Get Your API Key โ†’

Authentication

All API requests require your API key passed as a request header. Get your key from the Developer Portal.

Header
x-api-key: aud_your_api_key_here

// Or as Bearer token:
Authorization: Bearer aud_your_api_key_here
Keep your API key secret. Never expose it in client-side JavaScript, mobile app code, or public repositories. Use it only in server-side code.

Base URL

https://app.audlabs.io/api/v1

Generate Voice

POST /api/v1/generate

Convert text to speech. Returns an MP3 audio file as binary data.

Request Body

ParameterTypeDescription
textrequiredThe text to convert to speech. Maximum 50,000 characters per request.
voice_idrequiredThe voice to use. See Voice IDs section below.
speedoptionalSpeech speed. Range: 0.5 to 2.0. Default: 1.0
pitchoptionalPitch adjustment. Range: -12 to 12. Default: 0
volumeoptionalVolume level. Range: 0.1 to 2.0. Default: 1.0
formatoptionalOutput format. Options: mp3, wav. Default: mp3

JavaScript Example

JavaScript
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();

Python Example

Python
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)

Response Headers

HeaderDescription
Content-Typeaudio/mpeg for MP3, audio/wav for WAV
X-Characters-UsedNumber of characters consumed by this request
X-Credits-RemainingYour remaining monthly credit balance

List Voices

GET /api/v1/voices

Returns a list of all available voices with their IDs and metadata.

JavaScript
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);

Check Balance

GET /api/v1/balance

Returns your current monthly credit balance and usage statistics.

Response
{
  "success": true,
  "credits": 4850000,
  "totalCharacters": 150000,
  "plan": "growth"
}

Voice IDs

Use these voice IDs in your generate requests. All voices are available on all plans.

English_CaptivatingStoryteller
Captivating Storyteller
English ยท Female
English_MaturePartner
Mature Partner
English ยท Male
English_FriendlyPerson
Friendly Person
English ยท Female
English_ReliableMentor
Reliable Mentor
English ยท Male
English_PatiencePatient
Patience
English ยท Female
English_PlayfulSangfroid
Playful
English ยท Male
English_DecisiveMentor
Decisive Mentor
English ยท Male
English_VoiceOfReason
Voice of Reason
English ยท Male
English_WarmthAndCare
Warmth and Care
English ยท Female
English_EasyGoing
Easy Going
English ยท Male
English_SteadfastProtector
Steadfast Protector
English ยท Male
English_Whisper
Whisper
English ยท Female
English_RomanticAura
Romantic Aura
English ยท Female
English_GentleExpression
Gentle Expression
English ยท Female
English_TenderAndCaring
Tender and Caring
English ยท Female
English_LeadingMan
Leading Man
English ยท Male
English_BrilliantCoach
Brilliant Coach
English ยท Male
English_SportsCommentator
Sports Commentator
English ยท Male
French_MaleNarrator
Male Narrator
French ยท Male
French_FemaleAnchor
Female Anchor
French ยท Female
Spanish_CaptivatingStoryteller
Captivating Storyteller
Spanish ยท Male
Spanish_SophisticatedLady
Sophisticated Lady
Spanish ยท Female
German_FriendlyMan
Friendly Man
German ยท Male
German_SweetLady
Sweet Lady
German ยท Female
Italian_Narrator
Narrator
Italian ยท Male
Italian_BraveHeroine
Brave Heroine
Italian ยท Female
Russian_Engaging_Historian_v1
Engaging Historian
Russian ยท Male
Russian_Gentle_Storyteller_v3
Gentle Storyteller
Russian ยท Female
Portuguese_BR_Engaging_Historian_v1
Engaging Historian
Portuguese ยท Male
Portuguese_BR_Female_Gentle_Storyteller_v1
Gentle Storyteller
Portuguese ยท Female
Ukrainian_WiseScholar
Wise Scholar
Ukrainian ยท Male
Ukrainian_CalmWoman
Calm Woman
Ukrainian ยท Female
Afrikaans_male_1_v1
Pieter
Afrikaans ยท Male
Afrikaans_female_1_v1
Annelie
Afrikaans ยท Female

This is a sample of available voices. AudLabs offers 190+ voices across 10+ languages โ€” the full list is available in your AudLabs dashboard under Voice Tools.

Error Codes

StatusCodeDescription
401UnauthorizedMissing or invalid API key. Check your x-api-key header.
402Payment RequiredNo active subscription or monthly credits exhausted. Subscribe at platform.audlabs.io.
429Rate LimitedExceeded 5 requests per minute. Slow down your request rate.
400Bad RequestMissing required parameters or invalid values in request body.
503Service UnavailableVoice generation temporarily at capacity. Retry after a few seconds.
500Server ErrorInternal error. Contact hello@audlabs.io if this persists.

Pricing

Credits are purchased monthly at platform.audlabs.io. 1 credit = 1 character. Credits expire at the end of each month.

PlanMonthly PriceCharacters/MonthCost per 1M chars
Starter$15/mo3,000,000$5.00
Growth$40/mo10,000,000$4.00
Pro$90/mo20,000,000$4.50

Need a custom plan or have questions? Email hello@audlabs.io