Skip to main content

Обзор

Это кастомный Python-плагин для платформы Coze, который оборачивает модель Nano Banana Pro от APIYI (gemini-3-pro-image-preview) в узел, который любой workflow Coze может вызывать напрямую. Плагин включает полноценный конструктор запросов, детальную классификацию ошибок, обнаружение нарушений контента и загрузку в Aliyun OSS — на выходе вы получаете публичный URL, готовый к отображению, поэтому вам не нужен дополнительный узел пересылки на последующих этапах.
Информация о проекте
  • 📦 Форма: распространяется как пакет кода (не опубликован на GitHub)
  • 👤 Автор: Shuaila1996
  • 🎯 Платформы: пользовательские плагины Coze CN / Global
  • 🔌 Модель: gemini-3-pro-image-preview (через APIYI)
  • 📝 Полный исходный код встроен ниже в разделе «Полный исходный код плагина» — просто скопируйте и вставьте, отдельная загрузка не нужна

Основные возможности

Единый text-to-image / image-to-image

Автоматически переключается между режимами txt2img и img2img в зависимости от того, пуст ли fileurls — вам не нужны две параллельные ветки в рабочем процессе

Редактирование по нескольким референсам

Передайте массив URL изображений, и они будут загружены и внедрены как inline_data, с сохранением исходных деталей

Гранулярная классификация ошибок

Различает ZERO_CANDIDATES_TOKEN, FINISH_REASON, INLINE_DATA_EMPTY, TEXT_RESPONSE и другие, чтобы ветки workflow могли реагировать точно

Автоматическая маркировка нарушений

Для prompts на удаление водяных знаков / face-swap / NSFW / выход за пределы knowledge cutoff возвращает понятный тип отказа вместо того, чтобы заставлять пользователей гадать

Прямая загрузка в OSS

Результат base64 загружается напрямую в Aliyun OSS — ваш рабочий процесс получает URL, готовый к публикации или хранению

Таймаут с учетом разрешения

Независимые таймауты для 1K / 2K / 4K (360s / 600s / 1200s), чтобы задания 4K HD не обрывались раньше времени

Поддерживаемые модели APIYI

Плагин вызывает эндпоинт https://api.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent APIYI (нативный протокол Gemini), идентичный Google AI Studio — поэтому существующие prompt переносятся без проблем.

Архитектура плагина

Конфигурация плагина Coze Основной поток:

Входные и выходные данные

Вход

Выход

Развертывание

1

Шаг 1: Подготовьте учётные данные APIYI и OSS

  • Сгенерируйте ключ APIYI (начинается с sk-) в APIYI Console
  • Создайте бакет Aliyun OSS и RAM-подучётную запись с разрешением oss:PutObject для этого бакета
  • Запишите AccessKey ID, AccessKey Secret, Bucket name и Endpoint (например, oss-cn-beijing.aliyuncs.com)
2

Шаг 2: Создайте пользовательский плагин в Coze

  1. Перейдите в Coze Workspace → Library → Create custom plugin
  2. Выберите «Cloud-side plugin — create in Coze IDE»
  3. Runtime: Python
  4. Добавьте зависимости: requests, oss2
3

Шаг 3: Вставьте код плагина

Скопируйте полный Python-код из раздела «Полный исходный код плагина» ниже в Coze IDE, затем замените 4 строки конфигурации OSS в начале файла на свои значения:
4

Шаг 4: Настройте метаданные, входные и выходные данные

Настройте поля Input / Output и обязательные флаги, как указано ниже, в соответствии с полями args.input в коде:Конфигурация метаданных плагина Coze
5

Шаг 5: Проверьте и опубликуйте

  • В Coze IDE заполните тестовые параметры (рекомендуется: 1K + простой prompt, чтобы сначала проверить путь OSS)
  • Когда индикатор станет зелёным, нажмите «Опубликовать», и узел можно будет перетаскивать в любой workflow

Стратегия классификации ошибок

Плагин не просто возвращает boolean — он определяет причины сбоя в таком порядке приоритета, чтобы ветви workflow могли реагировать по-разному:

Полный исходный код плагина

Ниже приведен полный coze-nanobanana-pro.py. Вы можете скопировать его в Coze IDE как есть — просто обновите 4 строки конфигурации OSS вверху, и он будет готов к публикации.
coze-nanobanana-pro.py

Использование в workflow Coze

После публикации перетащите узел плагина в ваш рабочий процесс Coze и подключите его так:
Сочетайте его с рабочим процессом генерации изображений с ИИ для Feishu Bitable для конвейера без кода — операторам достаточно заполнять строки в Feishu Bitable, чтобы массово генерировать изображения.

FAQ

Нисходящим узлам workflow Coze (особенно ярлыкам полей Feishu) обычно нужен доступный URL, чтобы преобразовать результаты во вложения изображений. При возврате base64 данные неэффективно проходят через workflow, и Feishu не может отобразить их напрямую. Ссылки OSS также делают долговременное архивирование и внешнее распространение тривиальными.
Пользовательские плагины Coze пока не предоставляют системные переменные окружения. Рекомендуемый подход: храните учетные данные OSS как константы в верхней части файла и защищайте их с помощью функции шифрования плагинов Coze. Для многопользовательских workflow также записывайте префиксы для каждого tenant в путь OSS.
Чтобы распределять разные ключи для каждого вызывающего. Добавьте выше по потоку узел-словарь «API key для каждого пользователя», который сопоставляет имя вызывающего с его ключом APIYI — это удобно для учета использования и контроля доступа.
Генерация 4K в Nano Banana Pro действительно медленная (обычно 5–15 минут). Плагин уже настраивает тайм-аут 1200 секунд для 4K. Если тайм-аут все еще возникает:
  1. Переключитесь на 2K, чтобы отладить свой prompt
  2. Проверьте лимиты запросов в консоли APIYI
  3. Уменьшите количество параллельных запросов
Обычно это означает, что модель отказала (нарушение, ограничение по году и т. д.). Плагин автоматически классифицирует тип: удаление водяных знаков / замена лица / NSFW / год > 2025. Покажите пользователю поле errorне повторяйте попытку, результат будет тем же.
Да. Раздел «Полный исходный код плагина» выше содержит полный coze-nanobanana-pro.py (предоставлен Shuaila1996). Просто обновите 4 строки конфигурации OSS вверху и вставьте его в Coze IDE — отдельная загрузка не нужна.Если вам также нужны:

Связанные ресурсы

Генерация изображений с ИИ в Feishu Bitable

Идеальный спутник: подключите этот workflow Coze к Feishu Bitable, чтобы операторы просто заполняли строки для пакетной генерации

Документация Nano Banana Pro

Полная документация API Nano Banana Pro, тарификация и примеры генерации

FAQ по ошибкам генерации изображений

Руководство по устранению неполадок Nano Banana, согласованное с кодами ошибок этого плагина

APIYI Console

Управляйте ключами API, просматривайте использование и баланс