Обзор
Это пользовательский плагин на 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
fileurls — вам не нужны две параллельные ветки в рабочем процессеРедактирование по нескольким референсам
inline_data, с сохранением исходных деталейГранулярная классификация ошибок
ZERO_CANDIDATES_TOKEN, FINISH_REASON, INLINE_DATA_EMPTY, TEXT_RESPONSE и другие, чтобы ветки workflow могли реагировать точноАвтоматическая маркировка нарушений
Прямая загрузка в OSS
Таймаут с учетом разрешения
Поддерживаемые модели APIYI
Архитектура плагина

Входные и выходные данные
Вход
Выход
Развертывание
Шаг 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: Создайте пользовательский плагин в Coze
- Перейдите в Coze Workspace → Library → Create custom plugin
- Выберите «Cloud-side plugin — create in Coze IDE»
- Runtime: Python
- Добавьте зависимости:
requests,oss2
Шаг 3: Вставьте код плагина
Шаг 4: Настройте метаданные, входные и выходные данные
args.input в коде:
Шаг 5: Проверьте и опубликуйте
- В Coze IDE заполните тестовые параметры (рекомендуется: 1K + простой prompt, чтобы сначала проверить путь OSS)
- Когда индикатор станет зелёным, нажмите «Опубликовать», и узел можно будет перетаскивать в любой workflow
Стратегия классификации ошибок
Плагин не просто возвращает boolean — он определяет причины сбоя в таком порядке приоритета, чтобы ветви workflow могли реагировать по-разному:Полный исходный код плагина
Ниже приведён полныйcoze-nanobanana-pro.py. Его можно без изменений скопировать в Coze IDE — достаточно обновить 4 строки конфигурации OSS вверху, и можно публиковать.
Использование в workflow Coze
После публикации перетащите узел плагина в ваш рабочий процесс Coze и подключите его так:FAQ
Почему загружать в OSS, а не возвращать base64?
Почему загружать в OSS, а не возвращать base64?
Можно ли использовать переменные окружения для конфигурации OSS?
Можно ли использовать переменные окружения для конфигурации OSS?
Почему apikey передается, а не задается жестко?
Почему apikey передается, а не задается жестко?
Генерация 4K по-прежнему завершается по тайм-ауту?
Генерация 4K по-прежнему завершается по тайм-ауту?
- Переключитесь на 2K, чтобы отладить свой prompt
- Проверьте лимиты запросов в консоли APIYI
- Уменьшите количество параллельных запросов
Что делать с ошибками TEXT_RESPONSE?
Что делать с ошибками TEXT_RESPONSE?
error — не повторяйте попытку, результат будет тем же.Где находится полный исходный код? Можно ли скопировать его напрямую?
Где находится полный исходный код? Можно ли скопировать его напрямую?
coze-nanobanana-pro.py (предоставлен Shuaila1996). Просто обновите 4 строки конфигурации OSS вверху и вставьте его в Coze IDE — отдельная загрузка не нужна.Если вам также нужны:- Ярлык полей Feishu → см. «Полный исходный код ярлыка полей Feishu» в Workflow генерации изображений AI в Feishu Bitable
- Код Aliyun FC → см. «Полный исходный код Aliyun Function Compute» в том же документе