Z.AI

Что это

Z.AI (Zhipu AI) — платформа моделей семейства GLM. Чат-эндпоинт совместим с форматом OpenAI, а остальные возможности живут на отдельных путях того же API: генерация изображений и видео, веб-поиск, распознавание речи и токенизатор. Интеграция подключается по личному API-ключу и даёт сценарию бота вести диалог, разбирать изображения, искать в интернете, генерировать картинки и видео, расшифровывать аудио и считать токены.

Требования

Аккаунт на z.ai.
Положительный баланс — все операции платные.
API-ключ из раздела API Keys.

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

Зарегистрируйтесь на z.ai и пополните баланс.
Откройте API Keys и создайте ключ.
Скопируйте ключ.
В конструкторе откройте Интеграции → найдите карточку Z.AI → Подключить.
Вставьте ключ в поле подключения и сохраните.
Нажмите Проверить соединение — интеграция сделает лёгкий запрос к токенизатору и покажет результат.

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

Операция	Что делает
Отправить сообщение	Диалог с моделью: системный промпт, история переписки, JSON-режим, режим рассуждений, потоковый вывод
Анализ изображения	Отвечает на вопрос по изображению (ссылка или file_id из Telegram) vision-моделью
Генерация изображения	Рисует картинку по описанию через `glm-image` и загружает её в Telegram ради стабильного `file_id`
Реакция на сообщение	Модель выбирает одну эмодзи-реакцию из заданного списка
Веб-поиск	Возвращает структурированную выдачу поисковика Z.AI: заголовки, ссылки, фрагменты текста и даты
Генерация видео	Создаёт ролик по описанию или по исходной картинке через `cogvideox-3`
Расшифровка аудио	Переводит голосовое сообщение или аудиофайл в текст через `glm-asr`
Подсчёт токенов	Считает, сколько токенов займёт текст в выбранной модели

Ограничения

Изображение на входе vision-модели — до 5 МБ и не больше 6000×6000 пикселей.
Аудио для расшифровки — только wav и mp3, до 25 МБ и не длиннее 30 секунд.
Описание для видео — не более 512 символов; длительность 5 или 10 секунд, частота 30 или 60 кадров/с.
Размеры для glm-image: сторона от 1024 до 2048 пикселей и кратна 32. У cogview-4 предел жёстче — сторона кратна 16 и не больше 2 Мпикс всего.
Токенизатор работает только с glm-4.6, glm-4.6v и glm-4.5.
Ссылки на сгенерированные изображения и видео живут 30 дней.

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

Генерация видео асинхронная: интеграция сама отправляет задачу и ждёт результат, опрашивая Z.AI до 5 минут. Блок всё это время держит выполнение сценария — не ставьте его в ветку, где пользователь ждёт быстрый ответ.

Загрузка результата в Telegram управляется чекбоксом «Не загружать в Telegram» в блоке — как и в остальных интеграциях, он включён по умолчанию. Пока он включён, доступна только {{результат.url}} — ссылка Z.AI, которая перестаёт работать через 30 дней, поэтому сохраните файл сами, если он нужен надолго. Снимите галочку, чтобы бот залил результат в Telegram и вернул постоянный {{результат.file_id}}.

У Z.AI нет эндпоинта со списком моделей, поэтому выпадающий список в блоке заполняется из перечня моделей, задокументированных платформой. Если Z.AI выпустит новую модель, её код можно ввести вручную в поле «Модель».

«Веб-поиск» — это не диалог с моделью, а прямой запрос к поисковику: он возвращает массив источников ({{результат.0.title}}, {{результат.0.link}} и так далее), а не готовый ответ. Чтобы получить связный текст, передайте найденное в «Отправить сообщение» следующим шагом.