API reference

The Chariot API turns text into natural-sounding speech in English and Indian languages. Every endpoint is authenticated with a single API key and returns predictable JSON errors.

Base URL

All requests go to the production host:

https://api.chariot.in

Authentication

Send your API key in the chariotai-api-key header on every request. Generate a key from the Chariot dashboard.

curl https://api.chariot.in/v1/voices \
  -H "chariotai-api-key: YOUR_API_KEY"

Your API key carries the billing and access rights of your workspace. Keep it server-side and never expose it in client code or public repositories. See Authentication for key types and origin restrictions.

Your first request

Convert a line of text to speech and save the audio:

curl -X POST https://api.chariot.in/v1/tts \
  -H "chariotai-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_id": "bac7d666-094d-4698-91fa-741d60fce662",
    "text": "Hello from Chariot."
  }' \
  --output speech.wav

The audio is returned as the response body (audio/wav). Metadata comes back in the response headers:

Header	Meaning
`Inference-Id`	Unique id for this generation
`Audio-Url`	Persistent link to the same audio
`Credit-Utilized`	Credits charged (equal to the character count)

Errors

Every error uses the same JSON envelope:

{
  "statusCode": 404,
  "error": "EntityNotFoundException",
  "message": "Voice with id: 00000000-0000-0000-0000-000000000000 does not exist!"
}

See Errors & status codes for the full list.

Next steps

Quickstart

Go from zero to your first stream in a few minutes.

Text to speech

REST, HTTP streaming, and WebSocket compared.

Credits & pricing

How usage is metered and billed.

Rate limits & concurrency

Concurrency limits per plan and how to handle 429s.

Getting started

Text to speech

Voices

Account

Base URL

Authentication

Your first request

Errors

Next steps

Quickstart

Text to speech

Credits & pricing

Rate limits & concurrency

​Base URL

​Authentication

​Your first request

​Errors

​Next steps

Quickstart

Text to speech

Credits & pricing

Rate limits & concurrency

Base URL

Authentication

Your first request

Errors

Next steps