ComfyUI Node

心宝❤BananaV3

GPT Image 2, async submit, and a task center instead of a blocked graph

By 98624017·Created 9 months ago·Updated 5 months ago· 2
心宝❤BananaV3
  • image_1
  • image_2
  • image_3
  • image_4
  • image_5
  • binding_context
  • images
  • image_list
  • text
  • failed_urls
promptPeace and love
banana_api_key
model_typegemini-3-pro-image-preview
batch_size1
aspect_ratioAuto
seed-1
top_p0.95
image_size2K
线路心宝❤新渠道
联网搜索false
启用工作流并发false
大于5M限制长边禁用
仅提交不等待false
sizeauto
custom_width0
custom_height0
qualitymedium

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.

Category❤️‍🔥心宝专用

Inputs (23)

NameTypeDefaultDescription
promptSTRINGPeace and love生成图像的文本提示词,可多行描述内容、风格等
banana_api_keySTRING调用服务的 API Key;留空则优先使用 config.ini 中的配置
model_typeCOMBOgemini-3-pro-image-preview选择要使用的模型
batch_sizeINT11–8一次请求中要生成的图片数量,范围 1~8
aspect_ratioCOMBOAuto生成图像的宽高比例,Auto 为由服务端自动决定;1:4/4:1/1:8/8:1 仅 gemini-3.1-flash-image-preview 支持
seedoptINT-1-1–102400随机种子,-1 为自动随机;固定种子可复现同一输出
top_poptFLOAT0.950–1采样参数 Top-P,数值越低越保守,越高多样性越强
image_sizeoptCOMBO2K仅 gemini-3-pro-image 系列生效的分辨率选项
image_1optIMAGE参考图像 1,可为空;用于图生图或多图融合
image_2optIMAGE参考图像 2,可为空;用于图生图或多图融合
image_3optIMAGE参考图像 3,可为空;用于图生图或多图融合
image_4optIMAGE参考图像 4,可为空;用于图生图或多图融合
image_5optIMAGE参考图像 5,可为空;用于图生图或多图融合
线路optCOMBO心宝❤新渠道异步生图线路选择
binding_contextoptBANANA_BINDING(可选)来自“心宝❤绑定生成/透传”的绑定上下文,仅在搭配绑定增强节点时需要
联网搜索optBOOLEANfalse开启后模型可联网搜索辅助生成(注意:生图模型可能会忽略此工具)
启用工作流并发optBOOLEANfalse启用后,多个 BananaV2/视频节点可在同一工作流中并发发起 API 调用;默认关闭以保持更保守的资源占用。开启并发时单节点失败不会终止整图。
大于5M限制长边optCOMBO禁用上传图片超过5MB时的处理策略:禁用则仅转格式(JPEG q90),开启则强制缩放长边至指定像素
仅提交不等待optBOOLEANfalse开启后任务提交到任务中心即返回,不阻塞工作流。在右下角任务中心查看进度。
sizeoptCOMBOautoGPT Image 输出尺寸;自定义宽高同时大于 0 时优先
custom_widthoptINT00–3840GPT Image 自定义宽度,0 表示使用 size
custom_heightoptINT00–3840GPT Image 自定义高度,0 表示使用 size
qualityoptCOMBOmediumGPT Image 质量档位;gpt-image-2 非 OAI 版会忽略该参数

Outputs (4)

NameTypeDescription
imagesIMAGE
image_listIMAGE
textSTRING
failed_urlsSTRING