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

# Обзор

> Общайтесь с любым агентом Chattler из своего кода через небольшой REST API.

К любому агенту Chattler можно обратиться по HTTPS с API-ключом. Запрос через API выполняется тем же рантаймом, что и Telegram, WhatsApp или чат-страница: системный промпт агента, база знаний, инструменты и история диалога работают одинаково, а ответы оплачиваются с баланса владельца тем же способом.

## Что умеет API

<CardGroup cols={2}>
  <Card title="Чат" icon="message" href="/api-reference/public-api/send-a-message-to-the-agent-and-wait-for-the-reply">
    Отправьте одно сообщение пользователя и получите ответ агента вместе с расходом токенов и списанной суммой.
  </Card>

  <Card title="Стриминг" icon="bolt" href="/ru/guides/streaming">
    Тот же запрос, но ответ приходит токен за токеном в виде server-sent events.
  </Card>

  <Card title="Диалоги" icon="comments" href="/ru/guides/conversations">
    Получите список диалогов вашего ключа и постранично прочитайте их сообщения.
  </Card>

  <Card title="Быстрый старт" icon="rocket" href="/ru/get-started/quickstart">
    Первый ответ за пять минут с curl, Python или Node.
  </Card>
</CardGroup>

## Основное

|                |                                                                             |
| -------------- | --------------------------------------------------------------------------- |
| Базовый URL    | `https://api.chattler.ai`                                                   |
| Префикс пути   | `/v1`                                                                       |
| Аутентификация | `Authorization: Bearer cht_live_<key_id>.<secret>`                          |
| Формат         | JSON на входе, JSON на выходе; `text/event-stream` для потокового эндпоинта |
| Ошибки         | Один конверт: `{"error": {"code", "message", "request_id"}}`                |
| Лимит запросов | 120 запросов за 60 секунд на ключ                                           |

Ключ принадлежит ровно одному агенту. Его доступ — либо `read-only` (список диалогов и чтение сообщений), либо `full` (плюс чат).

## Эндпоинты

| Метод  | Путь                                                             | Доступ                 |
| ------ | ---------------------------------------------------------------- | ---------------------- |
| `POST` | `/v1/agents/{agent_id}/chat`                                     | `full`                 |
| `POST` | `/v1/agents/{agent_id}/chat/stream`                              | `full`                 |
| `GET`  | `/v1/agents/{agent_id}/conversations`                            | `read-only` или `full` |
| `GET`  | `/v1/agents/{agent_id}/conversations/{conversation_id}/messages` | `read-only` или `full` |

## Как устроены диалоги

Вы не создаёте диалоги. Каждый запрос в чат указывает `external_user_id` — стабильный идентификатор конечного пользователя на вашей стороне. Каждое сообщение от того же внешнего пользователя через тот же ключ продолжает тот же диалог; у другого ключа, даже для того же агента, своя отдельная история. См. [Диалоги](/ru/guides/conversations).

<Note>
  В этом релизе поддерживается только текст: сообщение — это строка, вложения не принимаются. Каждый ответ содержит заголовок `X-Request-ID`; указывайте его, когда сообщаете о проблеме.
</Note>