心宝❤BananaV3
GPT Image 2, async submit, and a task center instead of a blocked graph
- image_1
- image_2
- image_3
- image_4
- image_5
- binding_context
- images
- image_list
- text
- failed_urls
This is the "I need this to behave like a job queue, not a sampler" version of the pack's Gemini node. V3 adds two things the earlier versions don't have: OpenAI's GPT Image 2 as a first-class model option, and a submit-and-walk-away mode where generation happens in the pack's background task center instead of blocking your graph.
If V1 is "type a prompt, wait," V3 is "fire the request, keep editing the workflow, collect the image when the task center says it's done." For the batch e-commerce workflows this pack targets, that's the difference between babysitting a generation and actually getting other work done.
What changed vs V2
model_type now spans seven choices. The five Gemini models are still there, plus gpt-image-2 and gpt-image-2-oai - OpenAI's image model via the same reseller channel. That's the headline: one node, both Google and OpenAI image models, one key.
仅提交不等待 (submit only, don't wait), default off. With this on, the node submits the task to the pack's task center and returns immediately. Progress shows in the bottom-right "task center" panel (the same one the video nodes use), and the result comes back when the poller finishes. This is the async mode, and it's how you run a big batch without pinning ComfyUI's UI to a spinner. The trade-off is that your downstream nodes wait on the task's result rather than on the request.
GPT Image sizing controls. When a GPT model is selected, size offers 25 presets - auto, then 1K and 2K presets at 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, 21:9 and more - plus custom_width and custom_height (0–3840, step 16) that override size when both are above zero. And quality (low/medium/high, default medium) - note the tooltip: the non-OAI gpt-image-2 ignores quality, only the OAI build honors it.
Four outputs instead of three. You get images (single tensor), image_list (the same batch as an IMAGE list, useful when downstream nodes iterate per image), text, and failed_urls. The failed_urls output is the same rescue port as V2 - feed it to the 心宝❤失败链接汇总 aggregator.
What's the same
All the Gemini behavior carries over: prompt, banana_api_key (blank inherits from config.ini), aspect_ratio, seed, top_p, image_size, five reference images, binding_context, 联网搜索, 启用工作流并发, and the >5M限制长边 upload policy. One difference worth noting: V3 only offers the 心宝❤新渠道 route - the older Hong Kong/US/CF channel options are gone here, because this node targets the newer channel's async task system.
Installing and running
Same pack, same steps as the rest:
cd ComfyUI/custom_nodes
git clone https://github.com/98624017/comfyui-banana-li-linux
Restart ComfyUI. Dependencies are the pack's usual: requests, opencv-contrib-python, scikit-image, segment-anything, blend_modes, timm, Pillow, psd-tools.
Where people trip up: they enable submit-only mode, watch the graph "finish" instantly, and then wonder where the image is - it's in the task center, still rendering. Check there before assuming the run failed. And remember the billing reality from the KB's closed-source models analysis: GPT Image and Gemini Pro are both metered per image, and async mode makes it easier to burn through a balance without noticing, because nothing is visibly waiting. Treat the task center like a meter, not a fire-and-forget convenience.
Inputs (23)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | Peace and love | 生成图像的文本提示词,可多行描述内容、风格等 |
| banana_api_key | STRING | 调用服务的 API Key;留空则优先使用 config.ini 中的配置 | |
| model_type | COMBO | gemini-3-pro-image-preview | 选择要使用的模型 |
| batch_size | INT | 11–8 | 一次请求中要生成的图片数量,范围 1~8 |
| aspect_ratio | COMBO | Auto | 生成图像的宽高比例,Auto 为由服务端自动决定;1:4/4:1/1:8/8:1 仅 gemini-3.1-flash-image-preview 支持 |
| seedopt | INT | -1-1–102400 | 随机种子,-1 为自动随机;固定种子可复现同一输出 |
| top_popt | FLOAT | 0.950–1 | 采样参数 Top-P,数值越低越保守,越高多样性越强 |
| image_sizeopt | COMBO | 2K | 仅 gemini-3-pro-image 系列生效的分辨率选项 |
| image_1opt | IMAGE | 参考图像 1,可为空;用于图生图或多图融合 | |
| image_2opt | IMAGE | 参考图像 2,可为空;用于图生图或多图融合 | |
| image_3opt | IMAGE | 参考图像 3,可为空;用于图生图或多图融合 | |
| image_4opt | IMAGE | 参考图像 4,可为空;用于图生图或多图融合 | |
| image_5opt | IMAGE | 参考图像 5,可为空;用于图生图或多图融合 | |
| 线路opt | COMBO | 心宝❤新渠道 | 异步生图线路选择 |
| binding_contextopt | BANANA_BINDING | (可选)来自“心宝❤绑定生成/透传”的绑定上下文,仅在搭配绑定增强节点时需要 | |
| 联网搜索opt | BOOLEAN | false | 开启后模型可联网搜索辅助生成(注意:生图模型可能会忽略此工具) |
| 启用工作流并发opt | BOOLEAN | false | 启用后,多个 BananaV2/视频节点可在同一工作流中并发发起 API 调用;默认关闭以保持更保守的资源占用。开启并发时单节点失败不会终止整图。 |
| 大于5M限制长边opt | COMBO | 禁用 | 上传图片超过5MB时的处理策略:禁用则仅转格式(JPEG q90),开启则强制缩放长边至指定像素 |
| 仅提交不等待opt | BOOLEAN | false | 开启后任务提交到任务中心即返回,不阻塞工作流。在右下角任务中心查看进度。 |
| sizeopt | COMBO | auto | GPT Image 输出尺寸;自定义宽高同时大于 0 时优先 |
| custom_widthopt | INT | 00–3840 | GPT Image 自定义宽度,0 表示使用 size |
| custom_heightopt | INT | 00–3840 | GPT Image 自定义高度,0 表示使用 size |
| qualityopt | COMBO | medium | GPT Image 质量档位;gpt-image-2 非 OAI 版会忽略该参数 |
Outputs (4)
| Name | Type | Description |
|---|---|---|
| images | IMAGE | — |
| image_list | IMAGE | — |
| text | STRING | — |
| failed_urls | STRING | — |