Инструменты · key

aichatbot ИИ-чат-бот

Работает с ИИ-чат-ботом: нейросеть отвечает с учётом всей истории чата, как в интерфейсе. Чаты общие с интерфейсом — созданные по API видны в инструменте, и наоборот. Операция выбирается параметром action. Сообщение асинхронное: action=message возвращает task_id, ответ забирается action=answer. Разовый ответ без истории — в aicontent с part=chat_bot.

Режим
асинхронный: task_id
Стоимость
цена модели за сообщение; чаты и чтение бесплатно
Одновременно
одно сообщение в работе
Чатов
до 1000

Справочник моделей

GET /api/aichatbot

Текстовые нейросети чат-бота. Модели картинок и видео — справочники aiimages и aivideo.

Параметры query

  • models int обязательный
    Любое непустое значение — вернуть справочник.

Ответ

  • models[].name string
    Название модели в интерфейсе.
  • models[].value string
    Значение для параметра model.
  • models[].isVision bool
    Понимает изображения.
  • models[].isWebSearch bool
    Поддерживает web_search.
  • default string
    Модель по умолчанию.

Создать чат

POST /api/aichatbot

Пустой чат. Бесплатно.

Параметры query и тело формы

  • action string обязательный
    Операция.
    create
    создать чат
  • mode string обязательный
    Тип чата.
    text
    переписка
    image
    картинки
    video
    видео
  • title string
    Название, до 64 символов.

Отправить сообщение

POST /api/aichatbot

Ставит ход нейросети. Лимиты списываются при постановке и возвращаются, если ответ не получился. Пока предыдущее сообщение в работе, новое не принимается.

Параметры query и тело формы

  • action string обязательный
    Операция.
    message
    отправить сообщение
  • chat_id string обязательный
  • model string обязательный
    value модели: для text — из справочника, для image и video — из справочников aiimages и aivideo.
  • message string обязательный
    Текст сообщения или промпт, до 20 000 символов.
  • mode string
    Что сгенерировать.
    text
    ответ нейросети
    image
    картинку
    video
    видео 10 с, 1080p
    По умолчанию text
  • web_search bool
    Только text и модели с isWebSearch: ответ с поиском в интернете, по отдельной цене.
  • image_url string
    Только image и video: публичная ссылка на исходное изображение.

Ответ

Получить ответ

GET /api/aichatbot

Повторяйте раз в 5–15 секунд, пока status равен inprogress. Текст обычно готов за минуту, картинки — до 10 минут, видео — до 30.

Параметры query

  • action string обязательный
    Операция.
    answer
    ответ на сообщение
  • task_id string обязательный
    task_id из отправки сообщения.

Ответ

  • status string
    inprogress или success.
  • answer.content string
    Текст ответа (Markdown).
  • answer.urls string[]
    Ссылки на картинки или видео — для image и video.
  • answer.web_search_result object|null
    Источники, если был web_search.

Список чатов

GET /api/aichatbot

Параметры query

  • action string обязательный
    Операция.
    chats
    список чатов

История чата

GET /api/aichatbot

Сообщения по порядку. waiting — task_id хода, который ещё в работе, иначе false.

Параметры query

  • action string обязательный
    Операция.
    chat
    история чата
  • chat_id string обязательный

Переименовать, избранное

POST /api/aichatbot

Параметры query и тело формы

  • action string обязательный
    Операция.
    update
    изменить чат
  • chat_id string обязательный
  • title string
    Новое название, до 64 символов.
  • favorite bool
    1 — в избранное, 0 — убрать. Нужен title или favorite.

Удалить чат

POST /api/aichatbot

Необратимо. С all=1 удаляются все чаты, кроме избранных.

Параметры query и тело формы

  • action string обязательный
    Операция.
    delete
    удалить
  • chat_id string
    Чат; не нужен с all.
  • all bool
    1 — удалить все неизбранные чаты.

Ошибки

КодСообщениеКогда
-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_*.
Обратная связь и помощь
Если у вас есть идеи, как улучшить данный инструмент или остались вопросы по работе с ним, напишите в нашу службу поддержки, мы обязательно вам поможем.