---
title: "Welcome"
description: "What Qomni Agents is, what its API does and which rules every endpoint shares, so you can choose where to start."
version: "en"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.qomni.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

Qomni is Agents: AI agents that answer the phone, call your customers and
talk in real time from your app. It has a web app to manage them and an API
to put them in your code. The whole API follows the same rules: the same
keys, the same errors and the same test mode. If you learn one endpoint, you
know how to use them all.

## What the API does

| Resource | What you do with it | Where |
|---|---|---|
| Calls | An agent calls a number and tells you how it ended | `POST /calls`, `GET /calls` |
| Realtime sessions | Your app opens a voice or text conversation with an agent, without exposing your key | `POST /realtime/sessions` and a WebSocket |
| Key context | Check a key and see which cell your workspace lives in | `GET /ping` |

The API lives on a single host, `api.qomni.ai`: the path starts with the product
and then the version, `https://api.qomni.ai/agents/v1`. It speaks JSON and is versioned in the path.
Within a version, fields are only added, never removed: your client must
ignore the fields it does not know.

## What holds for every endpoint

- **One key per mode.** `sk_agents_test_…` to test,
  `sk_agents_live_…` for production. See [API keys and authentication](/concepts/authentication/).
- **A single host.** Your code does not pick a region: the key carries the
  cell and the edge routes. See [The edge and the cells](/concepts/edge/).
- **The same error shape.** `code` for your code, `message` for
  people, `request_id` for support. See [Errors](/concepts/errors/).
- **Test mode without consequences.** The same API, without dialing or
  billing anything. See [Test mode](/concepts/test-mode/).

## Where to start

- [Quickstart](/get-started/quickstart/) — Check a key and have an agent call a number, in five minutes.
- [Talk to an agent in real time](/agents/realtime/) — Create a session, open the socket and talk from your app.
- [Concepts](/concepts/) — The rules that hold for the whole API.
- [API reference](/agents-api/) — Every endpoint, field and error, generated from the contract.

Source: https://docs.qomni.ai/get-started/index.mdx
