Callrolin TTS · Urdu AI Voice

Overview

Callrolin TTS API provides state-of-the-art Urdu text-to-speech synthesis, deployed on-premise. Send Urdu text and receive high-quality WAV audio in response.

Base URL
http://34.93.31.201:8000

All API requests use JSON request bodies and return audio/wav responses. Authentication is required for all /v1/ endpoints.

Authentication

Authenticate your requests by including your API key in the X-API-Key header.

Your API Key

Enter your API key above and all code examples will update automatically. Contact your administrator to get an API key.

Header	Value	Required
`X-API-Key`	Your secret API key	Required
`Content-Type`	`application/json`	Required

Alternatively, pass the key as a Bearer token:

Authorization: Bearer hmnv-your-api-key

POST /v1/tts/synthesize

Convert Urdu text to speech. Returns a WAV audio file.

POST http://34.93.31.201:8000/v1/tts/synthesize

Request Body

Parameter	Type	Required	Default	Description
`model`	string	Required	·	Model ID. Must be `humnava-v2`
`text`	string	Required	·	Urdu text to synthesize. Max 2000 chars.
`noise_scale`	float	Optional	0.667	Pronunciation variety. Range 0 to 1.
`length_scale`	float	Optional	1.0	Duration multiplier. 0.5 = 2× faster, 2.0 = 2× slower.
`noise_scale_w`	float	Optional	0.8	Rhythm variation. Range 0 to 1.

Response

Returns audio/wav binary data with the following headers:

Header	Description
`X-Request-Id`	Unique request identifier (e.g. `req_a3f8b2c1d4e5`)
`X-Model`	Model used for synthesis (`humnava-v2`)
`X-Latency-Ms`	Server side inference time in milliseconds
`X-Text-Chars`	Number of characters in the input text

Code Examples

Models

Currently one model is available. Additional models will be released in future versions.

Model ID	Language	Sample Rate	Description
`humnava-v2`	Urdu (ur)	22,050 Hz	High-quality neural TTS. Single speaker, female voice. Trained on 30+ hours of studio audio.

List Models

GET http://34.93.31.201:8000/v1/models

curl http://34.93.31.201:8000/v1/models

Error Codes

The API uses standard HTTP status codes. Error responses include a JSON body with an error object.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Max 3 concurrent requests. Retry shortly.",
    "type": "rate_limit_error"
  }
}

HTTP Status	Error Code	Cause
401	missing_api_key	No API key provided in request headers
401	invalid_api_key	API key is incorrect or has been deactivated
400	invalid_model	Model ID is not recognized
422	·	Request body validation failed (missing field or wrong type)
429	rate_limit_exceeded	Server is at max capacity (3 concurrent). Retry after a moment.
500	inference_error	Internal model error during synthesis

اردو لکھیں،قدرتی آواز سنیں