Skip to content

Flux 3 Image · Edit Image

Integrate

Model id blackforestlabs/flux-3/edit-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/edit-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.048 48 API credits Run it on this page

Get API key
Black Forest Labs Image Editing 4K outputup to 4k #flux-3-image#black-forest-labs#multi-reference

FLUX 3 image editor that makes local edits and merges up to 10 reference images

Black Forest Labs · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Prompt that guides image generation.

•required image_urls
Drop a file, or · up to 10

Reference images supplied through URLs or data URIs; automatic aspect ratio follows image 1 in the sequence running through image 10. Both dimensions must measure at least 256 pixels. Automatic downscaling caps oversized images at 4 megapixels without altering their proportions.

resolution default 1k

Resolution tier for the output; generating at 4k may require several minutes.

default auto

Aspect ratio for the output. During editing, Auto matches the ratio of the first reference image.

Advanced output_format · version · safety_tolerance · enable_prompt_expansion
output_format default jpeg

File format for the resulting image.

default latest

Version of the model to use.

default 2

Safety tolerance ranging from the strictest setting, 0, to 4.

POST /run/blackforestlabs/flux-3/edit-image?wait=20 quote → $0.048
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/blackforestlabs/flux-3/edit-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Flux 3 Image · Edit Image

Edits an image or composes a result from 1 to 10 references in `image_urls`, each at least 256 pixels per side. Choose an `aspect_ratio` from 14 options or leave it on auto, which follows the first reference. `resolution` offers 512sq, 768sq, 1k, 2k and 4k, and 4k can take several minutes. Optional prompt expansion and jpeg or png output are available.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
Prompt that guides image generation.
image_urlsrequired images
Typeurl[] · image
≤ 10 items
Reference images supplied through URLs or data URIs; automatic aspect ratio follows image 1 in the sequence running through image 10. Both dimensions must measure at least 256 pixels. Automatic downscaling caps oversized images at 4 megapixels without altering their proportions.
aspect_ratiooptional
Typeenum
Defaultauto
auto21:92:116:93:27:54:35:41:14:53:45:72:39:161:2
Aspect ratio for the output. During editing, Auto matches the ratio of the first reference image.
resolutionoptional
Typeenum
Default1k
512sq768sq1k2k4k
Resolution tier for the output; generating at 4k may require several minutes.
enable_prompt_expansionoptional
Typeboolean
Defaultfalse
Controls prompt expansion without changing the intended meaning or reference roles.
safety_toleranceoptional
Typeinteger
Default2
0 – 4
Safety tolerance ranging from the strictest setting, 0, to 4.
output_formatoptional
Typeenum
Defaultjpeg
jpegpng
File format for the resulting image.
versionoptional
Typestring
Defaultlatest
Version of the model to use.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/edit-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 48,
    "usd": "0.048",
    "charged": 48,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}Image produced by the model.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/blackforestlabs/flux-3/edit-image.md. All models and guides: https://doitong.com/developers/llms.txt