API Documentation

Vaja AI Voice API

Powerful multilingual text-to-speech and speech-to-text APIs with support for 11 languages

11 Languages
6 Voices
Real-time
Secure

Base URL

https://vaja.ai/api/v1

Authentication

All API requests require authentication using your API key

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

⚠️Keep your API key secure! Never commit it to version control or expose it in client-side code.

Text-to-Speech (TTS)

POST

Convert text to natural-sounding speech in 11 languages

Endpoint

/voice/synthesize

Request Body

ParameterTypeRequiredDescription
textstring
Yes
The text to convert to speech
voicestring
No
Voice ID (alloy, echo, fable, onyx, nova, shimmer)
languagestring
No
Language code (en, es, fr, de, ar, ja, zh, ru, tr, pl, hi)

Example Request

curl -X POST https://vaja.ai/api/v1/voice/synthesize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, this is Vaja AI speaking!",
    "voice": "alloy",
    "language": "en"
  }' \
  --output speech.mp3

Response

Returns audio file (MP3 format)

Speech-to-Text (STT)

POST

Transcribe audio to text with automatic language detection

Endpoint

/voice/transcribe

Request Body (multipart/form-data)

ParameterTypeRequiredDescription
audiofile
Yes
Audio file (mp3, wav, m4a, etc.)
languagestring
No
Language hint for better accuracy

Example Request

curl -X POST https://vaja.ai/api/v1/voice/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "audio=@recording.mp3"

Response

{
  "text": "Hello, this is the transcribed text",
  "language": "en",
  "duration": 3.5,
  "confidence": 0.98
}

Supported Languages

🇺🇸

English

en

🇪🇸

Spanish

es

🇫🇷

French

fr

🇩🇪

German

de

🇸🇦

Arabic

ar

🇯🇵

Japanese

ja

🇨🇳

Chinese

zh

🇷🇺

Russian

ru

🇹🇷

Turkish

tr

🇵🇱

Polish

pl

🇮🇳

Hindi

hi

Rate Limits

Requests per minute
60
Requests per hour
1000
Monthly limit (Free tier)
3000

Error Codes

CodeDescription
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
429Rate Limit Exceeded
500Internal Server Error

Ready to get started?