Text-to-speech API for Urdu, Hindi and English

How the text-to-speech API works

1. Step 1

   Create a server-side key

   Sign in, accept the API Beta Terms and create a key on the API access page. Store it in an environment variable on your server.

2. Step 2

   Send text, a voice and a model

   POST your text to /v1/text-to-speech/{voice_id} with the xi-api-key header, model_id voicely-flash-v1 and an optional language_code.

3. Step 3

   Receive an MP3

   The response body is the finished audio (MP3, 44.1 kHz, 128 kbps). Save it or serve it to your users from your backend.

One request, one MP3. Run it on your server with the key in an environment variable:

# A new unique Idempotency-Key per synthesis (uuidgen on macOS/Linux; /proc fallback on Linux)
IDEMPOTENCY_KEY="$(uuidgen 2>/dev/null || cat /proc/sys/kernel/random/uuid)"

curl --fail-with-body -sS -X POST \
  "https://api.tryvoicely.com/v1/text-to-speech/vly_f02?output_format=mp3_44100_128" \
  -H "xi-api-key: $VOICELY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{"text":"Hello from the Voicely API.","model_id":"voicely-flash-v1","language_code":"en"}' \
  --output speech.mp3

Node.js and Python versions, every parameter and the full error list are in the Voicely API reference. The machine-readable OpenAPI 3.1 specification describes the same endpoints.

What developers build with it

Urdu, Hindi, English and every Studio language

The API accepts every language available in Voicely Studio: 31 languages, as an ISO code (es) or an exact Studio locale (es-MX). Urdu works in Urdu script, or in Roman Urdu with language_code ur. 30 built-in voices are available; Urdu uses two dedicated voices, one female and one male, and Urdu sent with any other voice ID is read by the dedicated voice of the same gender (the response headers say which voice was used).

Also available: Arabic, Bangla, Dutch, French, German, Indonesian, Italian, Japanese, Korean, Marathi, Polish, Portuguese, Romanian, Russian, Spanish, Tamil, Telugu, Thai, Turkish, Ukrainian, Vietnamese, Chinese Mandarin, Punjabi, Gujarati, Kannada, Malayalam, Hebrew, Swahili. The codes and locales are listed in the API reference.

Moving from another TTS API

Billing and limits in plain language

• Each completed request is charged in 100-character blocks, rounded up, from your API wallet.
• Purchased Voicely credits cover API usage only if you switch that on, and only up to a daily limit you choose. Website free and trial credits are never used by the API.
• There is no ongoing free tier. Eligible accounts may request one device-verified trial with 12,000 API characters. The trial is added directly to your API wallet.
• A request that fails before it completes is not charged. Retrying with the same Idempotency-Key returns the stored result without a second charge.
• Limits per account: 1,000 characters per request, 10 requests per minute, 1 request at a time.

Your balances and spend setting are on the API access page.

Getting help

Most errors explain themselves: every error response has a code, and the API reference error table says what to do for each one. If you are still stuck, contact support with the request ID from the response, the time in UTC, the endpoint and the HTTP status. Never send your API key or sensitive text.

Text-to-speech API questions