# FLUX 2 Lora Edit API

> 입력 이미지 최대 4개에 LoRA 가중치 최대 3개를 적용하는 FLUX 2 이미지 편집

`prompt`와 `image_urls`의 원본 이미지 최대 4개를 사용해 이미지를 편집하고, 특정 스타일 또는 도메인을 위해 `loras`의 LoRA를 최대 3개 적용합니다. `guidance_scale`(0~20), 4~50단계, `acceleration` 및 선택적 프롬프트 확장을 지원합니다. jpeg, png 또는 webp 형식의 이미지를 최대 4개 반환합니다.

- Model id: `flux-2/lora/edit`
- Made by: Black Forest Labs
- Category: Image Editing
- Output: image
- Price per megapixel: $0.021 / megapixel (cheapest run $0.021 (21 API credits))
- Run: `POST https://api.doitong.com/v1/run/flux-2/lora/edit`
- Quote: `POST https://api.doitong.com/v1/quote/flux-2/lora/edit`
- Docs page: https://doitong.com/ko/developers/models/flux-2/lora/edit

## Pricing

Price: **$0.021 / megapixel**. Price per megapixel: 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.042 = 42 API credits (2 MP × $0.021).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/flux-2/lora/edit` 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 |  |  | 이미지 생성을 안내하는 프롬프트입니다. |
| `guidance_scale` |  | number | no | `2.5` | 0 – 20 | 표시할 관련 이미지를 검색할 때 모델의 프롬프트 준수 정도를 guidance scale로 나타낸 설정입니다. |
| `seed` |  | integer \| null | no |  |  | 생성 시드 재정의입니다. 생략하면 생성 시드가 무작위로 선택됩니다. |
| `num_inference_steps` |  | integer | no | `28` | 4 – 50 | 실행할 추론 단계 수입니다. |
| `image_size` |  | object {width, height} \| enum (string) \| null | no |  | `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` | 출력 이미지 크기입니다. 각 축은 최소 512, 최대 2048 픽셀로 제한됩니다. |
| `num_images` | `num_outputs` | integer | no | `1` | 1 – 4 | 생성할 이미지 수입니다. |
| `acceleration` |  | enum (string) | no | `regular` | `none`, `regular`, `high` | 이미지 생성 가속 설정입니다. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | 자동 프롬프트 향상입니다. true는 결과 개선을 위해 프롬프트를 확장합니다. |
| `enable_safety_checker` |  | boolean | no | `true` |  | 안전 검사입니다. 안전하지 않은 것으로 표시된 이미지 대신 검은 이미지를 반환합니다. true는 검사를 활성화하고, false는 권한 있는 계정에서만 비활성화합니다. 권한이 없는 요청은 항상 검사됩니다. |
| `output_format` |  | enum (string) | no | `png` | `jpeg`, `png`, `webp` | 결과 이미지의 파일 형식입니다. |
| `image_urls` | `images` | array of image URL | yes |  | ≤ 4 items | 편집할 이미지의 URL입니다. 최대 4개까지 지정할 수 있습니다. |
| `loras` |  | array of object {path, scale} | no | `[]` |  | 위치를 URL, HuggingFace 저장소 ID 또는 로컬 경로로 나열하여 최대 3개의 LoRA 가중치를 적용합니다. |
| `loras[].path` |  | string | yes |  |  | LoRA 가중치의 위치입니다. URL, owner/repo 형식의 HuggingFace 저장소 ID 또는 로컬 경로로 지정합니다. |
| `loras[].scale` |  | number | no | `1` | 0 – 4 | LoRA에 적용되는 스케일링 계수로, 0.0~4.0 범위입니다. |

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.com/v1/run/flux-2/lora/edit?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/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/flux-2/lora/edit?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.com/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/flux-2/lora/edit", 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.com/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": "flux-2/lora/edit",
      "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": "flux-2/lora/edit",
  "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": 42,
    "usd": "0.042",
    "charged": 42,
    "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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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 | 이미지 생성 시드입니다. 입력에서 시드를 생략하면 무작위로 선택된 값이 포함되고, 그렇지 않으면 제공한 값이 반복됩니다. |
| `has_nsfw_concepts` | array of boolean | 생성된 이미지에 NSFW 개념이 나타나는지 나타냅니다. |
| `prompt` | string | 이미지 생성에 사용되는 프롬프트입니다. |

## Related models

- [FLUX 2 Flash](https://doitong.com/developers/models/flux-2/flash.md) (`flux-2/flash`): $0.005 / megapixel
- [FLUX 2 Lora](https://doitong.com/developers/models/flux-2/lora.md) (`flux-2/lora`): $0.021 / megapixel
- [FLUX 2 Turbo](https://doitong.com/developers/models/flux-2/turbo.md) (`flux-2/turbo`): $0.008 / megapixel
- [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2.md) (`flux-2`): $0.012 / megapixel
- [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro.md) (`flux-2-pro`): $0.015 / megapixel of output image
- [FLUX 2 Edit](https://doitong.com/developers/models/flux-2/edit.md) (`flux-2/edit`): $0.012 / megapixel
- [FLUX 2 Flash Edit](https://doitong.com/developers/models/flux-2/flash/edit.md) (`flux-2/flash/edit`): $0.005 / megapixel
- [FLUX 2 Pro Edit](https://doitong.com/developers/models/flux-2-pro/edit.md) (`flux-2-pro/edit`): $0.105 / run

## Links

- HTML page: https://doitong.com/developers/models/flux-2/lora/edit
- 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=flux-2/lora/edit
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/flux-2/lora/edit