メインコンテンツへスキップ

概要

Cozeプラットフォーム(www.coze.cn)向けのカスタムPythonプラグインです。APIYIのNano Banana Proモデル(gemini-3-pro-image)をラップし、Cozeワークフローから直接呼び出せるノードとして提供します。このプラグインには、完全なリクエストビルダー、詳細なエラー分類、コンテンツ違反の検出、Aliyun OSSへのアップロード機能が含まれています。返されるのは表示可能な公開URLなので、下流に追加の転送ノードを用意する必要はありません。
プロジェクト情報
  • 📦 形式: コードパッケージとして共有(GitHubでは公開されていません)
  • 👤 作者: Shuaila1996
  • 🎯 プラットフォーム: Coze CN / Globalのカスタムプラグイン
  • 🔌 モデル: gemini-3-pro-image(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 モデル

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

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

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

入力と出力

入力

出力

デプロイ

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 でカスタムプラグインを作成する

  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にコピーできます — 上部にあるOSS設定行4行を更新するだけで、公開できます。
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キーを管理し、使用量と残高を確認できます