VoxPilot API

Generate AI voice audio programmatically using the same 328-voice engine that powers the web app. Free, key-based access — no separate API pricing tier.

Introduction

The VoxPilot API lets you generate speech from text using any of the 328 available neural voices, with full control over speed, pitch, volume, and emotion — the same parameters available in the web studio.

Authentication

Every request to /api/v1/generate requires an API key, sent as a header. Generate a key from your Dashboard — it's shown once, so save it immediately.

X-API-Key: your_api_key_here

Generate Speech

Converts text to speech and returns a downloadable audio URL.

Field	Type	Required	Description
text	string	Yes	Text to convert. Max 5,000 characters.
voice	string	No	Voice ID. Default: en-US-JennyNeural. See /voices below.
speed	integer	No	-100 to 100. Default: 0.
pitch	integer	No	-50 to 50. Default: 0.
volume	integer	No	-50 to 50. Default: 0.
emotion	string	No	e.g. happy, sad, calm. Default: neutral.
intensity	float	No	0.2 to 2.0. Default: 1.0.

Example request (cURL):

curl -X POST https://voxpilot-ai.com/api/v1/generate \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the VoxPilot API",
    "voice": "en-US-GuyNeural",
    "emotion": "happy"
  }'

Example request (Python):

import requests

response = requests.post(
    "https://voxpilot-ai.com/api/v1/generate",
    headers={"X-API-Key": "your_api_key_here"},
    json={
        "text": "Hello from the VoxPilot API",
        "voice": "en-US-GuyNeural",
        "emotion": "happy"
    }
)
print(response.json())

Example response:

{
  "success": true,
  "audio_url": "https://voxpilot-ai.com/audio/a1b2c3.mp3",
  "download_url": "https://voxpilot-ai.com/download/a1b2c3.mp3",
  "characters_used": 27,
  "credits_remaining": 9973,
  "voice": "en-US-GuyNeural",
  "emotion": "happy"
}

List Voices

Returns all available voice IDs. No API key required for this endpoint.

curl https://voxpilot-ai.com/api/v1/voices

{
  "total": 328,
  "voices": [
    {
      "id": "en-US-JennyNeural",
      "name": "Jenny",
      "locale": "en-US",
      "gender": "Female",
      "language": "English"
    },
    // ...327 more
  ]
}

Error Codes

All errors return JSON: {"error": "description of what went wrong"}

Rate Limits

Endpoint	Limit
/api/v1/generate	30 requests per minute, per API key
/api/v1/voices	60 requests per minute, per IP

Credits

API usage draws from the same monthly credit pool as the web studio — 1 character generated = 1 credit used, whether generated via the API or the website. Check credits_remaining in every API response to track your balance, or view it anytime on your Dashboard.