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

​
Что умеет API

Чат

Отправьте одно сообщение пользователя и получите ответ агента вместе с расходом токенов и списанной суммой.

Стриминг

Тот же запрос, но ответ приходит токен за токеном в виде server-sent events.

Диалоги

Получите список диалогов вашего ключа и постранично прочитайте их сообщения.

Быстрый старт

Первый ответ за пять минут с curl, Python или Node.

​
Основное

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

​
Эндпоинты

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

Вы не создаёте диалоги. Каждый запрос в чат указывает external_user_id — стабильный идентификатор конечного пользователя на вашей стороне. Каждое сообщение от того же внешнего пользователя через тот же ключ продолжает тот же диалог; у другого ключа, даже для того же агента, своя отдельная история. См. Диалоги.
В этом релизе поддерживается только текст: сообщение — это строка, вложения не принимаются. Каждый ответ содержит заголовок X-Request-ID; указывайте его, когда сообщаете о проблеме.