POST /chat
https://api.cyberai.help/chat
Основной эндпоинт. Принимает JSON, отвечает потоком Server-Sent Events - ответ приходит по мере генерации, а не целиком в конце.
Тело запроса (JSON)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
заголовок X-Api-Key | string | да* | Ключ API из кабинета. * Либо он, либо публичный key в теле - но key принимается только из браузера. |
key | string | нет | Публичный ключ виджета (slug). Только для чата на странице: запрос без Origin или Referer отклоняется. |
message | string | да | Вопрос пользователя. |
history | array | нет | Память диалога: массив {role:"user"|"assistant", content:"..."}. Сервер берёт последние N - настройка «Память бота», по умолчанию 20. |
conversation_id | string | нет | Идентификатор сессии. В первом запросе не передавайте - сервер вернёт его в событии done. Передавайте в следующих запросах, чтобы вся сессия была одним диалогом. |
image | string | нет | Фото от пользователя как data-URL (data:image/jpeg;base64,..., до 8 МБ). Бот распознает содержимое и учтёт в ответе. |