Skip to main content

概要

これは、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_TOKENFINISH_REASONINLINE_DATA_EMPTYTEXT_RESPONSEなどを区別し、ワークフローの分岐が正確に反応できるようにします

違反の自動ラベリング

ウォーターマーク除去 / 顔交換 / NSFW / 知識カットオフ外のプロンプトに対して、推測を強いるのではなく、明確な拒否タイプを返します

OSS への直接アップロード

base64 の結果はそのまま Aliyun OSS にアップロードされ、ワークフローは共有や保存に使える URL を受け取れます

解像度を考慮したタイムアウト

1K / 2K / 4K ごとに個別のタイムアウトを設定し(360s / 600s / 1200s)、4K HD ジョブが途中で切れないようにします

対応 APIYI モデル

プラグインは APIYI のhttps://api.apiyi.com/v1beta/models/gemini-3-pro-image-preview:generateContent エンドポイント(Gemini ネイティブプロトコル)を呼び出します。Google AI Studio と同一なので、既存の prompt はそのまま移行できます。

プラグインアーキテクチャ

Coze プラグイン設定 基本フロー:

入力と出力

入力

出力

デプロイ

1

ステップ 1: APIYI と OSS の認証情報を準備する

  • APIYI Console で、sk- で始まる APIYI キーを生成します
  • Aliyun OSS Bucket と、そのバケットに対する oss:PutObject 権限を持つ RAM サブアカウントを作成します
  • AccessKey IDAccessKey SecretBucket name、および Endpoint を控えておきます(例: oss-cn-beijing.aliyuncs.com
2

ステップ 2: Coze でカスタムプラグインを作成する

  1. Coze Workspace → Library → カスタムプラグインを作成 に移動します
  2. 「Cloud-side plugin — create in Coze IDE」を選択します
  3. 実行環境: Python
  4. 依存関係を追加: requests, oss2
3

ステップ 3: プラグインコードを貼り付ける

以下の「プラグイン全文ソース」セクションにある完全な Python コードを Coze IDE にコピーし、その後、ファイル上部にある 4 行の OSS 設定を自分の値に更新してください:
4

ステップ 4: メタデータ、入力、出力を設定する

以下のように、入力 / 出力フィールドと必須フラグを設定し、コード内の args.input フィールドと一致させます:Coze プラグインのメタデータ設定
5

ステップ 5: テストして公開する

  • Coze IDE でテストパラメータを入力します(推奨: まず OSS パスを検証するために 1K + シンプルな prompt を使用します)
  • 緑になったら、「Publish」をクリックすると、ノードは任意のワークフローでドラッグ可能になります

エラー分類戦略

このプラグインは単に boolean を返すだけではありません。失敗原因を次の優先順位で識別するため、ワークフローの分岐がそれぞれ異なる反応を返せます。

プラグイン完全ソース

以下は完全な coze-nanobanana-pro.py です。これをそのまま Coze IDE にコピーできます。先頭の 4 つの OSS 設定行だけを更新すれば、公開準備は完了です。
coze-nanobanana-pro.py

Coze ワークフローでの使い方

公開後、プラグインノードを Coze ワークフローにドラッグし、次のように接続します。
Feishu Bitable AI 画像生成ワークフロー と組み合わせれば、ノーコードの生産ラインとして使えます。運用担当者は Feishu Bitable の行を埋めるだけで、画像を一括生成できます。

よくある質問

下流の Coze ワークフローノード(特に Feishu のフィールドショートカット)は、結果を画像添付に変換するために通常 アクセス可能な URL を必要とします。base64 を返すと、データがワークフロー内を非効率に移動することになり、Feishu では直接レンダリングできません。OSS リンクがあれば、長期アーカイブや外部共有も簡単です。
Coze のカスタムプラグインは、現時点ではシステム環境変数を公開していません。推奨される方法は、ファイルの先頭に OSS 認証情報を定数として保持し、Coze のプラグイン暗号化機能で保護することです。マルチテナントのワークフローでは、テナントごとのプレフィックスも OSS パスに書き込んでください。
呼び出し元ごとに異なるキーを配布するためです。上流に「ユーザーごとの API key」辞書ノードを追加し、呼び出し元の名前を APIYI キーにマッピングしてください。利用計測とアクセス制御の両方で扱いやすくなります。
Nano Banana Pro の 4K 生成は本当に遅いです(通常 5〜15 分)。このプラグインでは、すでに 4K 向けに 1200 秒のタイムアウトを設定しています。それでもタイムアウトする場合は:
  1. プロンプトのデバッグのために 2K に下げる
  2. APIYI コンソールでレート制限を確認する
  3. 同時実行数を減らす
これは通常、モデルが拒否したことを意味します(違反、年のカットオフなど)。プラグインはタイプを自動分類します: 透かし削除 / 顔交換 / 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 キーを管理し、使用状況と残高を確認できます