概要
api_yi_nano_banana_node は、コミュニティパートナーの JerrIsTheBesta によって提供された軽量な ComfyUI カスタムノードです。コンセプトは「そのまま使える手軽さ + 拡張しやすさ」です。custom_nodes ディレクトリに入れて ComfyUI を再起動するだけで、APIYI の Nano Banana Pro / Nano Banana 2 の画像生成をワークフロー内から直接呼び出せます。学習やカスタマイズを始めるのに最適な出発点です。
プロジェクト情報
- 🔗 ソース:
github.com/JerrIsTheBesta/api_yi_nano_banana_node - 📜 ライセンス: MIT
- 👤 著者: JerrIsTheBesta
- ⭐ コミュニティパートナーからの提供 — 拡張できるサンプルとして位置づけられています
コア機能
2つのコアノード
APIYI Text to Image + APIYI Multi Image Edit — 最も一般的な2つのワークフローをカバーしますデュアルモデル切り替え
gemini-3-pro-image-preview（Nano Banana Pro）とgemini-3.1-flash-image-previewのどちらかを選択します高解像度出力
解像度に応じた自動タイムアウト調整付きで 2K / 4K 出力をサポートします
豊富なアスペクト比
1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、5:4、4:5 を標準搭載 — 全10比率
マルチ画像編集
Multi Image Editは、ブレンド / スタイル転送向けに最大 5枚の参照画像 を受け付けます軽量でカスタマイズしやすい
最小限の依存関係（requests / Pillow / numpy）だけで構成された Pure Python 実装です。構造がシンプルで、カスタマイズしやすいです
対応 APIYI モデル
ノード詳細
APIYI テキストから画像
テキスト prompt から画像を生成します — 入力画像は不要です。出力: 生成画像 + ファイル名識別子。APIYI 複数画像編集
ブレンド、編集、または合成のために最大 5 枚の入力画像を受け付けます。出力: 結果画像、ファイル名、実際に使用された画像枚数。ノードパラメータ
インストール
1
ステップ 1: custom_nodes に配置します
ComfyUI のインストール先で、リポジトリを
custom_nodes にクローンします:2
ステップ 2: Python 依存関係をインストールします
依存関係は最小限です。ComfyUI には通常 torch が含まれています。足りないものがあれば残りをインストールしてください:
3
ステップ 3: ComfyUI を再起動します
再起動後、ノードパレットで
APIYI を検索すると、次が見つかります:APIYI Text to ImageAPIYI Multi Image Edit
4
ステップ 4: APIYI キーを設定します
- APIYI コンソール → Tokens を開き、利用上限付きの専用キーを作成します（セキュリティ上のベストプラクティス）
- キーをノードの
api_keyフィールドに貼り付けます - エンドポイントの設定は不要です — ノードは内部で
https://api.apiyi.comを使用します
5
ステップ 5: シンプルなワークフローを作成します
- テキストから画像生成:
APIYI Text to Image→Preview Image - 複数画像編集: 複数の
Load Image→APIYI Multi Image Edit→Preview Image
使用例
例1: テキストから画像へ
例2: 複数画像のブレンド
拡張アイデア
このプロジェクトは例であり出発点として位置付けられているため、必要に応じてフォークして拡張してください:会話的な編集
反復的なブラッシュアップのために、ノード内でセッションコンテキストを保持します
参照画像を増やす
上限を14枚に引き上げて、Nano Banana Pro のフルキャパシティに合わせます
シード制御
再現可能な生成のために seed パラメータを追加します
バッチ出力
画像のバッチを下流の ComfyUI ノードへ出力します
FAQ
ノードをインストールしたのにパレットで見つかりませんか？
ノードをインストールしたのにパレットで見つかりませんか？
- リポジトリが
ComfyUI/custom_nodes/内にあることを確認してください - ComfyUI を完全に再起動してください（フロントエンドを更新するだけではありません）
- Python の import エラーがないか、ComfyUI のコンソールを確認してください
呼び出しが 401 / 403 で失敗しますか？
呼び出しが 401 / 403 で失敗しますか？
確認してください:
api_keyが正しく、誤ったチャネルに制限されていないこと- 選択したモデルが token のホワイトリストに含まれていること
- 残高が十分であること — 残高は十分そうなのに呼び出しが失敗します を参照してください
4K 解像度でタイムアウトが頻発しますか？
4K 解像度でタイムアウトが頻発しますか？
このノードは 4K のタイムアウトを自動延長しますが、それでも失敗する場合は:
- API へのネットワーク経路を確認してください（CDN からの画像/動画ダウンロードが遅い を参照）
- 混雑時は 2K か Flash に切り替えてください
API key の漏えいは安全ですか？
API key の漏えいは安全ですか？
作者は master key を使わないことを明確に推奨しています — このノード専用に、APIYI コンソールで使用上限付きの専用 token を作成してください。そうすれば、漏えいしても影響範囲を限定できます。
他の ComfyUI-Nano-Banana-apiyi ノードと比べて何が違いますか？
他の ComfyUI-Nano-Banana-apiyi ノードと比べて何が違いますか？
- このノード: 軽量なサンプル、ノードは 2 個のみ、依存関係は最小限 — 導入とカスタマイズに最適
- 完全版: より豊富な機能セット（会話型編集、14 画像ブレンド）を備え、本番ワークフロー向けに設計
関連リソース
Nano Banana Pro API
Nano Banana Pro の完全な API リファレンス
フル機能の ComfyUI ノード
高機能な Nano Banana ComfyUI ノードパック
シナリオ概要
APIYI のシナリオをさらに見る
APIYI コンソール
API キーと利用状況を管理します