sd_generate_multiref: Generate an image conditioned on multiple reference images

In sd2R: Stable Diffusion Image Generation

Generate an image conditioned on multiple reference images

Description

Runs generation with one or more reference images, as used by edit / reference-conditioned models (e.g. Qwen-Image, FLUX control/edit variants). The references are passed straight through to the underlying generate_image C-API (ref_images); the active model decides how to use them, so this only has effect on models that support reference conditioning.

Usage

sd_generate_multiref(
  ctx,
  prompt,
  refs,
  negative_prompt = "",
  width = 512L,
  height = 512L,
  auto_resize_ref_image = TRUE,
  increase_ref_index = FALSE,
  sample_method = SAMPLE_METHOD$EULER,
  scheduler = SCHEDULER$DISCRETE,
  sample_steps = 20L,
  cfg_scale = 7,
  seed = 42L,
  clip_skip = -1L,
  eta = 0,
  batch_count = 1L
)

Arguments

ctx	SD context from sd_ctx
prompt	Text prompt
refs	A list of sd_image lists (each with width, height, channel, data), e.g. from sd_load_image.
negative_prompt	Negative prompt (default "")
width, height	Output size in pixels
auto_resize_ref_image	If TRUE (default), references are resized to fit the model's expected reference size.
increase_ref_index	If TRUE, reference latents get increasing positional indices (model-specific; default FALSE).
sample_method, scheduler	Sampler / scheduler (name or enum value)
sample_steps, cfg_scale, seed, clip_skip, eta	Standard sampling controls
batch_count	Number of images (default 1)

Value

List of sd_image lists.

See Also

sd_generate, sd_encode_image

sd2R documentation built on June 19, 2026, 9:08 a.m.