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.
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/v1Generate Voice
Convert text to speech and receive an MP3 audio file.
Request Body
| Parameter | Type | Description |
|---|---|---|
| text | required | The text to convert to speech. Max 50,000 characters. |
| voice_id | required | The voice to use. See Voice IDs section below. |
| speed | optional | Speech speed. Range: 0.5 to 2.0. Default: 1.0 |
| pitch | optional | Voice 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 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
| Header | Description |
|---|---|
| X-Characters-Used | Number of characters consumed by this request |
| X-Credits-Remaining | Your remaining credit balance after this request |
| Content-Type | audio/mpeg for MP3 output |
List 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
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.
Error Codes
| Status | Error | Description |
|---|---|---|
| 401 | Unauthorized | Missing or invalid API key |
| 402 | Insufficient Credits | Not enough credits. Top up at platform.audlabs.io |
| 400 | Bad Request | Missing required parameters or invalid values |
| 503 | Service Unavailable | Voice generation temporarily unavailable. Retry after a few seconds. |
| 500 | Server Error | Internal error. Contact hello@audlabs.io if this persists. |
Pricing
Credits are purchased at platform.audlabs.io. 1 credit = 1 character. Credits never expire.
| Plan | Price | Credits | Cost per 1M chars |
|---|---|---|---|
| Starter | $10 | 1,000,000 | $10.00 |
| Growth | $29 | 5,000,000 | $5.80 |
| Pro | $79 | 15,000,000 | $5.27 |
| Enterprise | $199 | 50,000,000 | $3.98 |
Need a custom plan or have questions? Email hello@audlabs.io