# FLUX.3 Klein Image Editing API

> FLUX.3 Klein-redigerer med opptil 10 referanser og valgfri objektplassering med avgrensningsbokser

Redigerer eller komponerer bilder fra en prompt og 1 til 10 referanser i `image_urls`, som prompten kan referere til etter rekkefølge, for eksempel det første bildet. Opptil 32 `bounding_boxes` kan beholde, flytte, endre størrelse på, fjerne eller legge til objekter som navngis med etikett i prompten. Utvidelse av prompten er aktivert som standard. Returnerer 1 til 4 bilder i jpeg-, png- eller webp-format.

- Model id: `blackforestlabs/flux-3/klein/edit-image`
- Made by: Black Forest Labs
- Category: Image Editing
- Output: image
- Price per run: from $0.008 / run of output image (cheapest run $0.008 (8 API credits))
- Run: `POST https://api.doitong.ru/v1/run/blackforestlabs/flux-3/klein/edit-image`
- Quote: `POST https://api.doitong.ru/v1/quote/blackforestlabs/flux-3/klein/edit-image`
- Docs page: https://doitong.com/no/developers/models/blackforestlabs/flux-3/klein/edit-image

## Pricing

Price: **from $0.008 / run of output image** (the lowest tier; the quote prices your exact input). Price per run: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

The full example input below costs $0.009 = 9 API credits (1 run × $0.009).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.ru/v1/quote/blackforestlabs/flux-3/klein/edit-image` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  |  | Skriv en full bildetekst som beskriver ønsket bilde etter redigering, og identifiser eventuelle referanser etter rekkefølge, for eksempel det første eller andre bildet. |
| `enable_prompt_expansion` |  | boolean | no | `true` |  | Promptutvidelse til en detaljert bildetekst før generering, aktivert når verdien er true. Ved redigering forankres bildeteksten i referansebildene. |
| `seed` |  | integer \| null | no |  |  | Seed for reproduserbare bilder: en identisk prompt og seed gir et identisk bilde når modellversjonen er uendret. |
| `num_images` | `num_outputs` | integer | no | `1` | 1 – 4 | Antall bilder som etterspørres for generering. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Aktivering av sikkerhetskontroll; true aktiverer kontroll. |
| `output_format` |  | enum (string) | no | `png` | `jpeg`, `png`, `webp` | Filformat for det resulterende bildet. |
| `image_urls` | `images` | array of image URL | yes |  | 1 – 10 items | Referansebilder brukt til redigering eller komposisjon, begrenset til 10. |
| `image_size` |  | object {width, height} \| enum (string) \| null | no |  | `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` | Utdatadimensjonene er som standard dimensjonene til den første referansen, begrenset til 1 megapiksel for flere referanser eller skalert til maksimalt 4 megapiksler for én referanse. Eksplisitte størrelser må ha hver side mellom 256 og 4096 piksler. |
| `bounding_boxes` |  | array of object {label, description, box, source_image_index, source_box, target_box} \| null | no |  | ≤ 32 items | Valgfri objektlayout for å beholde, flytte, endre størrelse på eller fjerne referanseobjekter, eller plassere nye objekter. Koordinatene starter ved (0, 0) øverst til venstre i hvert bilde; referer til bokser med etiketter i prompten, for eksempel `<dragon>`. |
| `bounding_boxes[].label` |  | string \| null | no |  | ≤ 64 characters | Kort objektetikett for boksen, for eksempel `dragon`; standarden er `obj_<n>`. Inkluder `<dragon>` i prompten for å knytte ordene til boksen; bokser som ikke er nevnt i prompten, legges til i scenen. |
| `bounding_boxes[].description` |  | string | yes |  | ≤ 500 characters | Objektet som skal gjengis i boksen, inkludert utseendet. |
| `bounding_boxes[].box` |  | object {x_min, y_min, x_max, y_max} \| null | no |  |  | Plassering av objektet i utdataene, som erstatter `source_box`/`target_box` og bruker samme plasseringsatferd som tekst-til-bilde. |
| `bounding_boxes[].box.x_min` |  | number | yes |  | 0 – 1 | Venstre grense uttrykt relativt til bildebredde, fra 0 til 1. |
| `bounding_boxes[].box.y_min` |  | number | yes |  | 0 – 1 | Øvre grense uttrykt relativt til bildehøyde, fra 0 til 1. |
| `bounding_boxes[].box.x_max` |  | number | yes |  | 0 – 1 | Høyre grense uttrykt relativt til bildebredde, fra 0 til 1. |
| `bounding_boxes[].box.y_max` |  | number | yes |  | 0 – 1 | Nedre grense uttrykt relativt til bildehøyde, fra 0 til 1. |
| `bounding_boxes[].source_image_index` |  | integer \| null | no |  | ≥ 0 | Valg av objektkilde: utelat for et nytt objekt, eller identifiser en eksisterende referanse med indeksen i `image_urls`, regnet fra 0. |
| `bounding_boxes[].source_box` |  | object {x_min, y_min, x_max, y_max} \| null | no |  |  | Objektets plassering i referansebildet; `source_image_index` må også oppgis. |
| `bounding_boxes[].source_box.x_min` |  | number | yes |  | 0 – 1 | Venstre grense uttrykt relativt til bildebredde, fra 0 til 1. |
| `bounding_boxes[].source_box.y_min` |  | number | yes |  | 0 – 1 | Øvre grense uttrykt relativt til bildehøyde, fra 0 til 1. |
| `bounding_boxes[].source_box.x_max` |  | number | yes |  | 0 – 1 | Høyre grense uttrykt relativt til bildebredde, fra 0 til 1. |
| `bounding_boxes[].source_box.y_max` |  | number | yes |  | 0 – 1 | Nedre grense uttrykt relativt til bildehøyde, fra 0 til 1. |
| `bounding_boxes[].target_box` |  | object {x_min, y_min, x_max, y_max} \| null | no |  |  | Plasseringsboks for objektet i utdataene: Flytting eller endring av størrelse krever begge bokser, mens et referert objekt fjernes ved å la denne boksen stå uangitt. |
| `bounding_boxes[].target_box.x_min` |  | number | yes |  | 0 – 1 | Venstre grense uttrykt relativt til bildebredde, fra 0 til 1. |
| `bounding_boxes[].target_box.y_min` |  | number | yes |  | 0 – 1 | Øvre grense uttrykt relativt til bildehøyde, fra 0 til 1. |
| `bounding_boxes[].target_box.x_max` |  | number | yes |  | 0 – 1 | Høyre grense uttrykt relativt til bildebredde, fra 0 til 1. |
| `bounding_boxes[].target_box.y_max` |  | number | yes |  | 0 – 1 | Nedre grense uttrykt relativt til bildehøyde, fra 0 til 1. |

File parameters (`images`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "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"
  ]
}
```

A fuller example:

```json
{
  "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"
  ]
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/blackforestlabs/flux-3/klein/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",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

### JavaScript

```javascript
const API = "https://api.doitong.ru/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/blackforestlabs/flux-3/klein/edit-image?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
    ]
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.ru/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
    ],
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/blackforestlabs/flux-3/klein/edit-image", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.ru/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "blackforestlabs/flux-3/klein/edit-image",
      "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"
        ]
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "blackforestlabs/flux-3/klein/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": 9,
    "usd": "0.009",
    "charged": 9,
    "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
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "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://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `images` | array of object {url, content_type, file_name, file_size, width, height} | Bilder produsert av modellen. |
| `timings` | object | Tidsinformasjon for genereringsprosessen. |
| `seed` | integer | Genereringsseed for det første bildet. |
| `has_nsfw_concepts` | array of boolean | Angir om NSFW-konsepter forekommer i de genererte bildene. |
| `prompt` | string | Prompt brukt under bildegenerering. |

## Related models

- [FLUX.3 Klein](https://doitong.com/developers/models/blackforestlabs/flux-3/klein/text-to-image.md) (`blackforestlabs/flux-3/klein/text-to-image`): from $0.008 / run of output image
- [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext.md) (`flux-pro/kontext`): $0.04 / image
- [GPT Image 2.5 Edit](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/edit.md) (`openai/gpt-image-2.5/flare/edit`): from $0.12 / image
- [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit.md) (`nano-banana-2/edit`): from $0.06 / image
- [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit.md) (`nano-banana-pro/edit`): from $0.15 / image
- [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit.md) (`alibaba/qwen-image-3/edit`): from $0.04 / image
- [Seedream 5.0 Pro Edit](https://doitong.com/developers/models/bytedance/seedream/v5/pro/edit.md) (`bytedance/seedream/v5/pro/edit`): from $0.0675 / run of output image
- [FLUX 2 Edit](https://doitong.com/developers/models/flux-2/edit.md) (`flux-2/edit`): $0.012 / megapixel

## Links

- HTML page: https://doitong.com/developers/models/blackforestlabs/flux-3/klein/edit-image
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=blackforestlabs/flux-3/klein/edit-image
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.ru/v1/models/blackforestlabs/flux-3/klein/edit-image