Nodes/ComfyUI-DeepGen-API/Generate Image (from 3 Images)
ComfyUI Node

Generate Image (from 3 Images)

DeepGen_I2I3

By deepiksdev·Created 8 months ago·Updated 6 months ago· 0
Generate Image (from 3 Images)
  • image_1
  • image_2
  • image_3
  • IMAGE
  • output_prefix_and_model
  • total_credits_used
model
prompt
seed_value1000
nb_results1
output_prefix
config_json
minimum_resolution1K
aspect_ratio1:1
output_formatpng

One reference image is good for keeping a subject recognizable. Three is how you tell a cloud model "this is definitely the same person/character, don't argue." DeepGen_I2I3 is the multi-reference image generation node in the DeepGen pack: feed it up to three images plus a prompt, and it produces a new image that has to reconcile all of them - the classic character-consistency move, done entirely in the cloud.

Why you'd use three references

This is the node for identity work. A single reference can drift when the model decides your prompt matters more than the picture. Three angles - a face-on shot, a profile, a full-body - give the model enough evidence that the thing it's drawing is that subject, not "a person who looks vaguely similar." It's the same trick the community uses with reference-heavy closed models, which are built for exactly this. If you're iterating on an OC, a character sheet, or a consistent product shot, this is the DeepGen node you'll reach for before the single-reference edit node.

The inputs

  • image_1, image_2, image_3 (IMAGE) - your references, all optional. You can use fewer than three; the node doesn't care if some stay unconnected. Wire in LoadImage, DeepGen_LIMG, or whatever you have.
  • prompt - what you want the result to do, on top of the references: "the woman from the references, standing in a sunlit garden." The model merges subject identity from the images with scene from the text.
  • model - dropdown of multi-reference-capable models: Hunyuan Image 3.0 Edit, Grok Imagine Image, Wan 2.6, GPT Image 1.5, Seedream 5.0 Fast Lite, Nano Banana Pro, Nano Banana 2. They vary in how faithfully they hold identity across multiple references, so expect to trial two or three.
  • minimum_resolution (500/1K/2K/4K), aspect_ratio, output_format - the usual trio, mapped onto the selected model's supported sizes.
  • nb_results, seed_value, output_prefix, config_json - standard pack behavior; config_json is the escape hatch for extra API params.

As with the other image nodes, each reference tensor becomes a base64 PNG attachment on the request, and the pack tries to preserve source filenames by tracing your graph, so what you sent stays identifiable.

Outputs

  • IMAGE - the generated image batch. Save it, preview it, or chain it into another DeepGen node.
  • output_prefix_and_model (STRING) and total_credits_used (FLOAT) - the same bookkeeping pair every DeepGen generator emits.

Install

Same pack as the rest:

cd ComfyUI/custom_nodes
git clone https://github.com/deepiksdev/ComfyUI-DeepGen-API.git
cd ComfyUI-DeepGen-API
pip install -r requirements.txt

Restart, then set your DeepGen API key in Settings → "DeepGen API Key" (stored at ComfyUI/user/deepgen/config.json). Only requests and opencv-python are installed - everything heavy is server-side.

Gotchas

Each generation spends credits and uploads your reference images to the cloud - don't send private work you're not comfortable leaving your machine. If identity still drifts with three references, that's the model's limit, not a settings bug; try a different model from the dropdown, because the reference-fidelity ranking changes between them. And note this node is current - there's no deprecated spelling for DeepGen_I2I3, unlike its single-reference cousin.

CategoryDeepGen/Generators

Inputs (12)

NameTypeDefaultDescription
modelCOMBO7 options: Hunyuan Image 3.0 Edit (hunyuan-image-v3-edit), Grok Imagine Image (grok-imagine-image), Wan 2.6 (wan-2.6), GPT Image 1.5 (gpt-image-1.5), Seedream 5.0 Fast Lite (seedream-v5-lite-edit), Nano Banana Pro (Gemini 3 Pro Image) (gemini-3-pro-image), +1
promptSTRING
seed_valueINT1000
nb_resultsINT11–10
output_prefixSTRING
config_jsonSTRING
image_1optIMAGE
image_2optIMAGE
image_3optIMAGE
minimum_resolutionoptCOMBO1K4 options: 500, 1K, 2K, 4K
aspect_ratiooptCOMBO1:114 options: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, +8
output_formatoptCOMBOpng3 options: png, jpeg, webp

Outputs (3)

NameTypeDescription
IMAGEIMAGE
output_prefix_and_modelSTRING
total_credits_usedFLOAT