API docs / Image models
multi-image-list API
Combines multiple input images into a single cohesive scene based on text prompts using FLUX Kontext Max. Takes a list of images and descriptive instructions to merge, transform, or blend elements from each image into a unified composition. Capable of transferring objects, people, or styling between images while maintaining photorealistic quality and coherent lighting.
- Model id
flux-kontext-apps/multi-image-list- 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-list". 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-list",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light",
"reference_images": [
"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
| Name | Type | Details |
|---|---|---|
promptrequired | string | Text description of how to combine or transform the input images |
reference_imagesrequired | array of URLs | List of input images. Must be jpeg, png, gif, or webp. Up to 10 files · Accepts image/* |
aspect_ratio | string | Default: 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 |
seed | number | Random seed. Set for reproducible generation |
output_format | string | Default: One of: jpg, png |