Перейти к основному содержанию

Обзор

Это пользовательский плагин на Python для платформы Coze (www.coze.cn), который оборачивает модель Nano Banana Pro от APIYI (gemini-3-pro-image) в узел, который можно напрямую вызывать из любого рабочего процесса Coze. Плагин включает полноценный конструктор запросов, детальную классификацию ошибок, обнаружение нарушений правил в контенте и загрузку в Aliyun OSS — в результате вы получаете общедоступный URL, готовый к отображению, поэтому дополнительный узел пересылки не требуется.
Информация о проекте
  • 📦 Форма: доступен в виде пакета с кодом (не опубликован на GitHub)
  • 👤 Автор: Shuaila1996
  • 🎯 Платформы: пользовательские плагины Coze CN / глобальной версии
  • 🔌 Модель: gemini-3-pro-image (через 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:generateContent APIYI (протокол Gemini), идентичный Google AI Studio, поэтому существующие промпты можно переносить без изменений.

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

Конфигурация плагина 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

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

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

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

Частые вопросы по ошибкам генерации изображений

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

Консоль APIYI

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