概要
これは、Cozeプラットフォーム向けのカスタム Python プラグインで、APIYI の Nano Banana Pro モデル(gemini-3-pro-image-preview)を、どの Coze ワークフローからも直接呼び出せるノードにラップしています。このプラグインには、完全なリクエストビルダー、きめ細かなエラー分類、コンテンツ違反検知、そして Aliyun OSS へのアップロードが含まれています。返ってくるのはそのまま表示できる公開 URL ですので、下流に追加の転送ノードを用意する必要はありません。
プロジェクト情報
- 📦 形式: コードパッケージとして共有されています(GitHub では公開していません)
- 👤 作成者: Shuaila1996
- 🎯 対応プラットフォーム: Coze CN / Global のカスタムプラグイン
- 🔌 モデル:
gemini-3-pro-image-preview(APIYI 経由) - 📝 完全なソースコードは下の「プラグイン完全ソース」セクションに埋め込まれています。コピー&ペーストするだけでよく、別途ダウンロードは不要です
主な機能
テキストから画像 / 画像から画像の統合
fileurlsが空かどうかに応じて txt2img と img2img モードを自動で切り替えます — ワークフローで 2 つの並列分岐を用意する必要はありませんマルチリファレンス編集
画像 URL の配列を渡すと、それらがダウンロードされ、
inline_dataとして挿入され、元のディテールを保持します詳細なエラー分類
ZERO_CANDIDATES_TOKEN、FINISH_REASON、INLINE_DATA_EMPTY、TEXT_RESPONSEなどを区別し、ワークフローの分岐が正確に反応できるようにします違反の自動ラベリング
ウォーターマーク除去 / 顔交換 / NSFW / 知識カットオフ外のプロンプトに対して、推測を強いるのではなく、明確な拒否タイプを返します
OSS への直接アップロード
base64 の結果はそのまま Aliyun OSS にアップロードされ、ワークフローは共有や保存に使える URL を受け取れます
解像度を考慮したタイムアウト
1K / 2K / 4K ごとに個別のタイムアウトを設定し(360s / 600s / 1200s)、4K HD ジョブが途中で切れないようにします
対応 APIYI モデル
プラグインアーキテクチャ

入力と出力
入力
出力
デプロイ
1
ステップ 1: APIYI と OSS の認証情報を準備する
- APIYI Console で、
sk-で始まる APIYI キーを生成します - Aliyun OSS Bucket と、そのバケットに対する
oss:PutObject権限を持つ RAM サブアカウントを作成します AccessKey ID、AccessKey Secret、Bucket name、およびEndpointを控えておきます(例:oss-cn-beijing.aliyuncs.com)
2
ステップ 2: Coze でカスタムプラグインを作成する
- Coze Workspace → Library → カスタムプラグインを作成 に移動します
- 「Cloud-side plugin — create in Coze IDE」を選択します
- 実行環境: Python
- 依存関係を追加:
requests,oss2
3
ステップ 3: プラグインコードを貼り付ける
以下の「プラグイン全文ソース」セクションにある完全な Python コードを Coze IDE にコピーし、その後、ファイル上部にある 4 行の OSS 設定を自分の値に更新してください:
4
ステップ 4: メタデータ、入力、出力を設定する
以下のように、入力 / 出力フィールドと必須フラグを設定し、コード内の 
args.input フィールドと一致させます:
5
ステップ 5: テストして公開する
- Coze IDE でテストパラメータを入力します(推奨: まず OSS パスを検証するために 1K + シンプルな prompt を使用します)
- 緑になったら、「Publish」をクリックすると、ノードは任意のワークフローでドラッグ可能になります
エラー分類戦略
このプラグインは単に boolean を返すだけではありません。失敗原因を次の優先順位で識別するため、ワークフローの分岐がそれぞれ異なる反応を返せます。プラグイン完全ソース
以下は完全なcoze-nanobanana-pro.py です。これをそのまま Coze IDE にコピーできます。先頭の 4 つの OSS 設定行だけを更新すれば、公開準備は完了です。
coze-nanobanana-pro.py
Coze ワークフローでの使い方
公開後、プラグインノードを Coze ワークフローにドラッグし、次のように接続します。よくある質問
なぜ base64 を返すのではなく OSS にアップロードするのですか?
なぜ base64 を返すのではなく OSS にアップロードするのですか?
下流の Coze ワークフローノード(特に Feishu のフィールドショートカット)は、結果を画像添付に変換するために通常 アクセス可能な URL を必要とします。base64 を返すと、データがワークフロー内を非効率に移動することになり、Feishu では直接レンダリングできません。OSS リンクがあれば、長期アーカイブや外部共有も簡単です。
OSS 設定に環境変数を使えますか?
OSS 設定に環境変数を使えますか?
Coze のカスタムプラグインは、現時点ではシステム環境変数を公開していません。推奨される方法は、ファイルの先頭に OSS 認証情報を定数として保持し、Coze のプラグイン暗号化機能で保護することです。マルチテナントのワークフローでは、テナントごとのプレフィックスも OSS パスに書き込んでください。
なぜ apikey はハードコードせずに渡すのですか?
なぜ apikey はハードコードせずに渡すのですか?
呼び出し元ごとに異なるキーを配布するためです。上流に「ユーザーごとの API key」辞書ノードを追加し、呼び出し元の名前を APIYI キーにマッピングしてください。利用計測とアクセス制御の両方で扱いやすくなります。
4K 生成がタイムアウトし続けますか?
4K 生成がタイムアウトし続けますか?
Nano Banana Pro の 4K 生成は本当に遅いです(通常 5〜15 分)。このプラグインでは、すでに 4K 向けに 1200 秒のタイムアウトを設定しています。それでもタイムアウトする場合は:
- プロンプトのデバッグのために 2K に下げる
- APIYI コンソールでレート制限を確認する
- 同時実行数を減らす
TEXT_RESPONSE エラーはどう対処しますか?
TEXT_RESPONSE エラーはどう対処しますか?
これは通常、モデルが拒否したことを意味します(違反、年のカットオフなど)。プラグインはタイプを自動分類します: 透かし削除 / 顔交換 / NSFW / 年 > 2025。
error フィールドをユーザーに表示してください — 再試行しないでください。結果は同じになります。完全なソースコードはどこですか?直接コピーできますか?
完全なソースコードはどこですか?直接コピーできますか?
はい。「Plugin Full Source」セクションには完全な
coze-nanobanana-pro.py が含まれています(Shuaila1996 により提供)。上部の 4 つの OSS 設定行を更新するだけで、Coze IDE に貼り付けられます。別途ダウンロードは不要です。さらに必要な場合:- Feishu のフィールドショートカット → Feishu Bitable AI 画像生成ワークフロー の「Feishu Field Shortcut Full Source」を参照してください
- Aliyun FC コード → 同じドキュメントの「Aliyun Function Compute Full Source」を参照してください
関連リソース
Feishu Bitable AI 画像生成
これ以上ない相棒です。この Coze ワークフローを Feishu Bitable に接続すれば、担当者は行を入力するだけで一括生成できます
Nano Banana Pro ドキュメント
Nano Banana Pro の完全な API ドキュメント、料金、生成サンプル
画像生成失敗 FAQ
このプラグインのエラーコードに対応した Nano Banana の障害切り分けガイド
APIYI コンソール
API キーを管理し、使用状況と残高を確認できます