Kheelona Voice
Kheelona Voice lets your app or toy hold a spoken conversation with a Kheelona voice. The person speaks, the voice listens and answers out loud, usually within about three seconds, in the language the person speaks. The person can interrupt the voice at any time.
You pick a voice from Kheelona’s catalogue, such as lumi-dragon. Each voice is a complete character with its own sound,
personality and safety level. You never choose or see the technology underneath: Kheelona runs and improves it.
What you get
Section titled “What you get”- Voices. The voices Kheelona has enabled for your account. See Voices and versions.
- Sessions. One session is one conversation between one person and one voice. Your server starts it, and a browser or your server connects to it. See Sessions.
- 11 languages. English, Hindi, Marathi, Bengali, Assamese, Gujarati, Punjabi, Tamil, Telugu, Kannada and Malayalam. Four are supported, five are beta and two are alpha. You choose the languages of each session. See Languages.
- Live text. The text of what was said, as it happens, for captions or your own records. Kheelona does not keep it. See Live text.
- Status events. Listening, thinking, speaking and interrupted, to drive a character or a talk button.
- Your own instructions. Free text for one session, such as a child’s first name. It is never stored in readable form.
- Safety. Every voice has a safety level, and Kheelona’s safety rules check what is said and what the voice is about to say. See Safety levels.
- Clear limits. You have a maximum number of sessions at once and a maximum session length. When Kheelona is busy a new session is refused straight away with a wait time. See Limits.
Two ways to connect
Section titled “Two ways to connect”| From a web page | From your server | |
|---|---|---|
| For | Web apps and pages | Toys, devices and backends that relay audio |
| How | The browser SDK, over WebRTC with a WebSocket fallback | A WebSocket |
| Start here | Quickstart for browsers | Quickstart for servers |
In both, your server creates the session with your API key. The key stays on your server. The page or device gets only a client secret that works once and for about a minute.
What to expect
Section titled “What to expect”- Best effort during the partner pilot. The launch is limited and partners are hand-picked. Planned maintenance is announced in advance.
- No sandbox. There is no separate test mode. You integrate against the live service, within your session limit. Read Going live before real users arrive.
- Response time is a target. Typically under 3 seconds from the end of speech to the first sound. See Latency.
- Kheelona keeps no conversation. No audio and no conversation text is stored.
Where to go next
Section titled “Where to go next”- Quickstart for browsers: a page that talks, in about 10 minutes.
- Quickstart for servers: a relay that talks, in a few minutes.
- Errors and retries: every error code and what to do.
- Security: keys, origins and a Content Security Policy.
- Examples: the code, in Node, Python, browser and curl.
Use these docs with an AI tool
Section titled “Use these docs with an AI tool”Every page has a Markdown version: use Download as Markdown at the bottom of the page. To get the whole documentation as one file, use Download all docs (Markdown) at the bottom of any page, or open the single file. llms.txt is an index of the Markdown pages.