AudLabs API Documentation

The AudLabs API gives developers access to 190+ professional AI voices to generate natural-sounding speech in any application. Built for scale, designed for simplicity.

Get Your API Key →

Introduction

The AudLabs API is a REST API that accepts JSON requests and returns audio files. You can use it to generate professional voiceovers, power voice features in your app or automate content creation workflows.

⚡ Every API request consumes credits from your account. Credits are purchased at platform.audlabs.io. 1 credit = 1 character of text.

Authentication

All API requests require authentication using your API key. Pass it as a request header:

x-api-key: aud_your_api_key_here

// Or as a Bearer token:
Authorization: Bearer aud_your_api_key_here

Get your API key from the Developer Portal. Keep it secret — do not expose it in client-side code.

Base URL

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

Generate Voice

POST /api/v1/generate

Convert text to speech and receive an MP3 audio file.

Request Body

ParameterTypeDescription
textrequiredThe text to convert to speech. Max 50,000 characters.
voice_idrequiredThe voice to use. See Voice IDs section below.
speedoptionalSpeech speed. Range: 0.5 to 2.0. Default: 1.0
pitchoptionalVoice pitch 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

Example Request

// 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'
  })
});

// Response is an MP3 audio file (binary)
const audioBlob = await response.blob();
const audioUrl = URL.createObjectURL(audioBlob);
# 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
  }
)

# Save audio file
with open('output.mp3', 'wb') as f:
  f.write(response.content)

Response Headers

HeaderDescription
X-Characters-UsedNumber of characters consumed by this request
X-Credits-RemainingYour remaining credit balance after this request
Content-Typeaudio/mpeg for MP3 output

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

Error Codes

StatusErrorDescription
401UnauthorizedMissing or invalid API key
402Insufficient CreditsNot enough credits. Top up at platform.audlabs.io
400Bad RequestMissing required parameters or invalid values
503Service UnavailableVoice generation temporarily unavailable. Retry after a few seconds.
500Server ErrorInternal error. Contact hello@audlabs.io if this persists.

Pricing

Credits are purchased at platform.audlabs.io. 1 credit = 1 character. Credits never expire.

PlanPriceCreditsCost per 1M chars
Starter$101,000,000$10.00
Growth$295,000,000$5.80
Pro$7915,000,000$5.27
Enterprise$19950,000,000$3.98

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