Developer Documentation | Horanadu Corporation

Note: These endpoints are currently in private beta. To request an API key, please contact api-access@horanaducorp.com.

Authentication

All API requests must be authenticated using a Bearer token. You can obtain your API key from the developer dashboard. Include the key in the Authorization header of your HTTP requests.

Authorization: Bearer hc_live_xxxxxxxxxxxxxxxxx

Bimbient Voice API

The Bimbient API allows you to synthesize speech from text and clone voices programmatically.

Generate Speech

Converts text to lifelike spoken audio.

POSThttps://api.horanaducorp.com/v1/audio/generate

Request Body

Parameter	Type	Description
text *	string	The text to synthesize. Maximum 4096 characters.
voice_id *	string	The ID of the voice to use.
model	string	The model to use. Defaults to `bimbient-turbo-v2`.

Example Request

curl -X POST https://api.horanaducorp.com/v1/audio/generate \
  -H "Authorization: Bearer $BIMBIENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello world, this is a synthetic voice.",
    "voice_id": "vz_91x72b",
    "model": "bimbient-turbo-v2"
  }'

Bahuti Social API

Programmatically schedule and manage social media content across platforms. (Coming soon)

Rate Limits

To ensure fair usage, our API is rate-limited per workspace. Rate limit status is returned in the response headers of every request.

X-RateLimit-Limit: The maximum number of requests permitted in the current window.
X-RateLimit-Remaining: The number of requests remaining in the current window.
X-RateLimit-Reset: The time at which the current rate limit window resets in UTC epoch seconds.

If you exceed the rate limit, you will receive a 429 Too Many Requests error response.

Webhooks

Horanadu Corporation uses webhooks to notify your application when an asynchronous event occurs, such as a long-running voice cloning job completing.

Webhook signatures are included in the X-HC-Signature header. You must verify this signature using your endpoint secret to ensure the request originated from us.