aichatbot ИИ-чат-бот
Работает с ИИ-чат-ботом: нейросеть отвечает с учётом всей истории чата, как в интерфейсе. Чаты общие с интерфейсом — созданные по API видны в инструменте, и наоборот. Операция выбирается параметром action. Сообщение асинхронное: action=message возвращает task_id, ответ забирается action=answer. Разовый ответ без истории — в aicontent с part=chat_bot.
- Режим
- асинхронный:
task_id - Стоимость
- цена модели за сообщение; чаты и чтение бесплатно
- Одновременно
- одно сообщение в работе
- Чатов
- до 1000
Справочник моделей
/api/aichatbot
Параметры query
-
modelsint обязательныйЛюбое непустое значение — вернуть справочник.
Ответ
-
models[].namestringНазвание модели в интерфейсе. -
models[].valuestringЗначение для параметраmodel. -
models[].isVisionboolПонимает изображения. -
models[].isWebSearchboolПоддерживаетweb_search. -
defaultstringМодель по умолчанию.
Создать чат
/api/aichatbot
Пустой чат. Бесплатно.
Параметры query и тело формы
-
actionstring обязательныйОперация. -
modestring обязательныйТип чата. -
titlestringНазвание, до 64 символов.
Отправить сообщение
/api/aichatbot
Ставит ход нейросети. Лимиты списываются при постановке и возвращаются, если ответ не получился. Пока предыдущее сообщение в работе, новое не принимается.
Параметры query и тело формы
-
actionstring обязательныйОперация. -
chat_idstring обязательный -
modelstring обязательный -
messagestring обязательныйТекст сообщения или промпт, до 20 000 символов. -
modestringЧто сгенерировать. -
web_searchboolТолькоtextи модели сisWebSearch: ответ с поиском в интернете, по отдельной цене. -
image_urlstringТолькоimageиvideo: публичная ссылка на исходное изображение.
Ответ
-
task_idstringID хода для получения ответа. -
chat_idstringЧат. -
statusstringqueued.
Получить ответ
/api/aichatbot
Повторяйте раз в 5–15 секунд, пока status равен inprogress. Текст обычно готов за минуту, картинки — до 10 минут, видео — до 30.
Параметры query
-
actionstring обязательныйОперация. -
task_idstring обязательныйtask_idиз отправки сообщения.
Ответ
-
statusstringinprogressилиsuccess. -
answer.contentstringТекст ответа (Markdown). -
answer.urlsstring[]Ссылки на картинки или видео — дляimageиvideo. -
answer.web_search_resultobject|nullИсточники, если былweb_search.
История чата
/api/aichatbot
Сообщения по порядку. waiting — task_id хода, который ещё в работе, иначе false.
Параметры query
-
actionstring обязательныйОперация. -
chat_idstring обязательный
Переименовать, избранное
/api/aichatbot
Параметры query и тело формы
-
actionstring обязательныйОперация. -
chat_idstring обязательный -
titlestringНовое название, до 64 символов. -
favoritebool1— в избранное,0— убрать. Нуженtitleилиfavorite.
Удалить чат
/api/aichatbot
Необратимо. С all=1 удаляются все чаты, кроме избранных.
Параметры query и тело формы
-
actionstring обязательныйОперация. -
chat_idstringЧат; не нужен сall. -
allbool1— удалить все неизбранные чаты.
Ошибки
| Код | Сообщение | Когда |
|---|---|---|
-100 |
tools errors |
Операция не выполнена, причина — в details: неизвестный action, нет обязательного параметра, чат не найден, модель недоступна, не хватает лимитов на сообщение, тариф без доступа к инструменту, предыдущее сообщение ещё в работе, фильтр 18+, ответ не получился. |
-51 |
No requests data |
Изменяющая операция (create, message, update, delete) вызвана не POST-запросом. |
-68, -80…-83 |
Not enough … limits |
Лимиты закончились — на любой вызов, включая чтение. |
-1, -2 |
Access denied |
Ключ не передан или не найден. |
Подводные камни
- Чаты общие с интерфейсом инструмента: удаление по API удаляет и там.
- Длинная история сжимается автоматически — нейросеть помнит суть, но не каждую реплику дословно.
- Те же операции доступны ИИ-агентам через MCP — инструменты
ai_chatbot_*.