# Kheelona Voice

> Talk to Kheelona voices from a web page or from your own server. Voice conversations for toys and apps, in 11 languages (four supported, five beta, two alpha).

Source: https://docs.voice.kheelona.com/

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

- **Voices.** The voices Kheelona has enabled for your account. See [Voices and versions](https://docs.voice.kheelona.com/concepts/voices.md).
- **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](https://docs.voice.kheelona.com/concepts/sessions.md).
- **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](https://docs.voice.kheelona.com/concepts/languages.md#supported-beta-and-alpha).
- **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](https://docs.voice.kheelona.com/concepts/live-text.md).
- **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](https://docs.voice.kheelona.com/concepts/safety-levels.md).
- **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](https://docs.voice.kheelona.com/concepts/limits.md).

## 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](https://docs.voice.kheelona.com/guides/browser-sdk.md), over WebRTC with a WebSocket fallback | A [WebSocket](https://docs.voice.kheelona.com/guides/server-to-server.md) |
| Start here | [Quickstart for browsers](https://docs.voice.kheelona.com/get-started/quickstart-browser.md) | [Quickstart for servers](https://docs.voice.kheelona.com/get-started/quickstart-server.md) |

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

- **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](https://docs.voice.kheelona.com/guides/going-live.md) before real users arrive.
- **Response time is a target.** Typically under 3 seconds from the end of speech to the first sound. See
  [Latency](https://docs.voice.kheelona.com/concepts/latency.md).
- **Kheelona keeps no conversation.** No audio and no conversation text is stored.

## Where to go next

- [Quickstart for browsers](https://docs.voice.kheelona.com/get-started/quickstart-browser.md): a page that talks, in about 10 minutes.
- [Quickstart for servers](https://docs.voice.kheelona.com/get-started/quickstart-server.md): a relay that talks, in a few minutes.
- [Errors and retries](https://docs.voice.kheelona.com/guides/errors-and-retries.md): every error code and what to do.
- [Security](https://docs.voice.kheelona.com/guides/security.md): keys, origins and a Content Security Policy.
- [Examples](https://docs.voice.kheelona.com/examples/browser-basic.md): the code, in Node, Python, browser and curl.

## 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](https://docs.voice.kheelona.com/llms-full.txt).
[llms.txt](https://docs.voice.kheelona.com/llms.txt) is an index of the Markdown pages.