Обзор
Это кастомный 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
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» в том же документе