Kimi

Что это

Kimi — линейка ИИ-моделей Moonshot AI с большим контекстным окном (до 1 млн токенов) и мультимодальными возможностями. API совместим с форматом OpenAI. Интеграция подключается по личному API-ключу и позволяет сценарию бота вести диалог с моделью, анализировать изображения, использовать встроенный веб-поиск модели и извлекать текст из загруженных файлов — прямо в сценарии.

Требования

Аккаунт на platform.kimi.ai.
API-ключ из раздела Console → API keys.

Как подключить

Войдите на platform.kimi.ai и откройте Console → API keys.
Создайте ключ и скопируйте его.
В конструкторе откройте Интеграции → найдите карточку Kimi → Подключить.
Вставьте ключ в поле подключения и сохраните.
Проверьте подключение кнопкой Проверить соединение — она показывает текущий баланс аккаунта.

Доступные операции

Операция	Что делает
Отправить сообщение	Диалог с моделью: системный промпт, история переписки, JSON-режим, потоковый вывод
Анализ изображения	Отвечает на вопрос по изображению (ссылка или file_id из Telegram)
Реакция на сообщение	Модель выбирает одну эмодзи-реакцию из заданного списка
Список моделей	Возвращает список доступных моделей с их параметрами
Веб-поиск	Диалог с автоматическим использованием встроенного веб-поиска модели, когда он нужен для ответа
Извлечь текст из файла	Загружает файл (PDF, DOCX, TXT и т.п.) и возвращает извлечённый из него текст

Ограничения

Каждая операция обращается к чат-эндпоинту Kimi (/v1/chat/completions) — токены расходуются согласно тарифам аккаунта.
Генерация изображений, эмбеддинги и модерация в API Kimi отсутствуют — соответствующих операций в интеграции нет.
«Веб-поиск» выполняет до нескольких обменов запросами с моделью за один вызов операции (пока модель не даст окончательный ответ) — это немного увеличивает время ответа и расход токенов по сравнению с обычным сообщением.

Особенности и примечания

Операция «Извлечь текст из файла» не отвечает на вопросы сама — она только достаёт текст из файла в переменную. Чтобы задать вопрос по документу, передайте {{результат.text}} в системный промпт операции «Отправить сообщение» следующим шагом сценария — так рекомендует сама документация Kimi.

В «Веб-поиске» решение о том, нужен ли поиск для ответа, принимает сама модель — если вопрос не требует свежих данных из интернета, поиск не выполняется и {{результат.used_search}} останется пустым.