API docs / Image models

multi-image-kontext-max API

Combines two input images based on a text prompt describing how to merge or transform them. Uses FLUX Kontext technology to blend, composite, or creatively merge multiple images according to textual instructions. Supports various aspect ratios and can maintain or modify the composition of the combined result.

Model id
flux-kontext-apps/multi-image-kontext-max
Provider
flux-kontext-apps
Output
Image
Price
From 28 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "flux-kontext-apps/multi-image-kontext-max". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "flux-kontext-apps/multi-image-kontext-max",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light",
    "input_image_1": [
      "https://example.com/input.png"
    ],
    "input_image_2": [
      "https://example.com/input.png"
    ]
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Text description of how to combine or transform the two input images

aspect_ratiostring

Default: match_input_image

One of: match_input_image, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21, 2:1, 1:2

seednumber

Random seed. Set for reproducible generation

output_formatstring

Default: png

One of: jpg, png

input_image_1requiredarray of URLs

First input image. Must be jpeg, png, gif, or webp.

Up to 1 files · Accepts image/*

input_image_2requiredarray of URLs

Second input image. Must be jpeg, png, gif, or webp.

Up to 1 files · Accepts image/*