API docs / Image models

FLUX 3 Image (Edit with references) API

Edit one image or combine up to 10 references with FLUX 3 Image.

Model id
blackforestlabs/flux-3/edit-image
Provider
Black Forest Labs
Output
Image
Price
From 17 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": "blackforestlabs/flux-3/edit-image". 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": "blackforestlabs/flux-3/edit-image",
  "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

NameTypeDetails
promptrequiredstring
reference_imagesrequiredarray of URLs

1 to 10 images, each at least 256 px per side and at most 4 MP. Refer to them as image 1, image 2 and so on; the first sets the auto aspect ratio.

Up to 10 files · Accepts image/*

aspect_ratiostring

Default: auto

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

resolutionstring

1k is about 1 MP, 2k about 4 MP, 4k about 16 MP. 4k can take several minutes.

Default: 1k

One of: 1k, 2k, 4k

enhance_promptboolean

Rewrite a short prompt into a fuller description while keeping its intent.

Default: false