# FLUX.3 Klein Image Editing API

> עורך FLUX.3 Klein עם עד 10 תמונות ייחוס ומיקום אובייקטים אופציונלי באמצעות תיבות תחימה

עורך או מרכיב תמונות מהנחיה ומ־1 עד 10 תמונות ייחוס ב־`image_urls`, שאליהן ההנחיה יכולה להתייחס לפי הסדר, למשל לתמונה הראשונה. עד 32 `bounding_boxes` יכולים לשמור, להזיז, לשנות גודל, להסיר או להוסיף אובייקטים, שמזוהים בהנחיה לפי תווית. הרחבת ההנחיה מופעלת כברירת מחדל. מוחזרות 1 עד 4 תמונות בפורמט jpeg, png או webp.

- 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/he/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 |  |  | יש לכתוב כיתוב מלא המתאר את התמונה הרצויה לאחר העריכה, ולזהות הפניות לפי הרצף, כגון התמונה הראשונה או השנייה. |
| `enable_prompt_expansion` |  | boolean | no | `true` |  | הרחבת הנחיה לכיתוב מפורט לפני היצירה, מופעלת כאשר הערך הוא true. בעריכה, הכיתוב מבוסס על תמונות ההפניה. |
| `seed` |  | integer \| null | no |  |  | seed לתמונות ניתנות לשחזור: הנחיה ו־seed זהים מפיקים תמונה זהה כאשר גרסת המודל לא השתנתה. |
| `num_images` | `num_outputs` | integer | no | `1` | 1 – 4 | מספר התמונות המבוקש ליצירה. |
| `enable_safety_checker` |  | boolean | no | `true` |  | הפעלת בודק הבטיחות; true מאפשר בדיקה. |
| `output_format` |  | enum (string) | no | `png` | `jpeg`, `png`, `webp` | פורמט הקובץ של התמונה שהתקבלה. |
| `image_urls` | `images` | array of image URL | yes |  | 1 – 10 items | תמונות הפניה המשמשות לעריכה או להרכבה, עד 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` | מידות הפלט כברירת מחדל הן של ההפניה הראשונה, עם הגבלה ל־1 מגה־פיקסל עבור כמה הפניות או שינוי קנה מידה לעד 4 מגה־פיקסל עבור הפניה יחידה. גדלים מפורשים חייבים לכלול צד שאורכו בין 256 ל־4096 פיקסלים. |
| `bounding_boxes` |  | array of object {label, description, box, source_image_index, source_box, target_box} \| null | no |  | ≤ 32 items | פריסת אובייקטים אופציונלית לשימור, הזזה, שינוי גודל או הסרה של אובייקטי הפניה, או למיקום אובייקטים חדשים. הקואורדינטות מתחילות ב־(0, 0) בפינה השמאלית העליונה של כל תמונה; יש להפנות לתיבות באמצעות תוויות בהנחיה, כגון `<dragon>`. |
| `bounding_boxes[].label` |  | string \| null | no |  | ≤ 64 characters | תווית אובייקט קצרה לתיבה, כגון `dragon`; ברירת המחדל היא `obj_<n>`. יש לכלול `<dragon>` בהנחיה כדי לקשר את מילותיה לתיבה; תיבות שאינן מוזכרות בהנחיה מתווספות לסצנה. |
| `bounding_boxes[].description` |  | string | yes |  | ≤ 500 characters | האובייקט לעיבוד בתוך התיבה, כולל המראה שלו. |
| `bounding_boxes[].box` |  | object {x_min, y_min, x_max, y_max} \| null | no |  |  | מיקום הפלט של האובייקט, המחליף את `source_box`/`target_box` ומשתמש בהתנהגות המיקום של text-to-image. |
| `bounding_boxes[].box.x_min` |  | number | yes |  | 0 – 1 | הגבול השמאלי, המבוטא ביחס לרוחב התמונה, מ־0 עד 1. |
| `bounding_boxes[].box.y_min` |  | number | yes |  | 0 – 1 | הגבול העליון, המבוטא ביחס לגובה התמונה, מ־0 עד 1. |
| `bounding_boxes[].box.x_max` |  | number | yes |  | 0 – 1 | הגבול הימני, המבוטא ביחס לרוחב התמונה, מ־0 עד 1. |
| `bounding_boxes[].box.y_max` |  | number | yes |  | 0 – 1 | הגבול התחתון, המבוטא ביחס לגובה התמונה, מ־0 עד 1. |
| `bounding_boxes[].source_image_index` |  | integer \| null | no |  | ≥ 0 | בחירת מקור האובייקט: יש להשמיט עבור אובייקט חדש, או לזהות הפניה קיימת לפי האינדקס שלה ב־`image_urls`, בספירה מ־0. |
| `bounding_boxes[].source_box` |  | object {x_min, y_min, x_max, y_max} \| null | no |  |  | מיקום האובייקט בתוך תמונת ההפניה; יש לספק גם `source_image_index`. |
| `bounding_boxes[].source_box.x_min` |  | number | yes |  | 0 – 1 | הגבול השמאלי, המבוטא ביחס לרוחב התמונה, מ־0 עד 1. |
| `bounding_boxes[].source_box.y_min` |  | number | yes |  | 0 – 1 | הגבול העליון, המבוטא ביחס לגובה התמונה, מ־0 עד 1. |
| `bounding_boxes[].source_box.x_max` |  | number | yes |  | 0 – 1 | הגבול הימני, המבוטא ביחס לרוחב התמונה, מ־0 עד 1. |
| `bounding_boxes[].source_box.y_max` |  | number | yes |  | 0 – 1 | הגבול התחתון, המבוטא ביחס לגובה התמונה, מ־0 עד 1. |
| `bounding_boxes[].target_box` |  | object {x_min, y_min, x_max, y_max} \| null | no |  |  | תיבת מיקום הפלט של האובייקט: הזזה או שינוי גודל דורשים את שתי התיבות, ואילו הסרת אובייקט שהופנה אליו דורשת להשאיר את התיבה הזו לא מוגדרת. |
| `bounding_boxes[].target_box.x_min` |  | number | yes |  | 0 – 1 | הגבול השמאלי, המבוטא ביחס לרוחב התמונה, מ־0 עד 1. |
| `bounding_boxes[].target_box.y_min` |  | number | yes |  | 0 – 1 | הגבול העליון, המבוטא ביחס לגובה התמונה, מ־0 עד 1. |
| `bounding_boxes[].target_box.x_max` |  | number | yes |  | 0 – 1 | הגבול הימני, המבוטא ביחס לרוחב התמונה, מ־0 עד 1. |
| `bounding_boxes[].target_box.y_max` |  | number | yes |  | 0 – 1 | הגבול התחתון, המבוטא ביחס לגובה התמונה, מ־0 עד 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} | תמונות שנוצרו על ידי המודל. |
| `timings` | object | פרטי תזמון תהליך היצירה. |
| `seed` | integer | seed היצירה עבור התמונה הראשונה. |
| `has_nsfw_concepts` | array of boolean | מציין אם מושגים מסוג NSFW מופיעים בתמונות שנוצרו. |
| `prompt` | string | הנחיה המשמשת במהלך יצירת התמונה. |

## 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