跳转到内容

FLUX.3 Klein Image Editing

集成

模型 id blackforestlabs/flux-3/klein/edit-image
# 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",
    "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://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

与示例类似的文件: $0.009 9 API 积分 · ≈ ₽0.97 运行前会测量你的文件 在此页面运行

获取 API 密钥
Black Forest Labs 图像编辑 #image-editing#image-to-image#reference-images#typography

FLUX.3 Klein 编辑器,支持最多 10 张参考图和可选的边界框对象放置

在 Doitong 上制作

Doitong 社区使用 FLUX.3 Klein 制作的公开作品。一键复用提示词。

显示的公开作品:9
Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lemb...

Close-up portrait seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut ...

Prompt Details Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikel...

Seorang wanita berkulit pucat berdiri setengah tubuh di dalam air berwarna lembut kebiruan, dikelilingi bunga teratai berkelopak penuh yang bermekaran indah di permukaan air. Rambutnya pirang pucat tersanggul longgar dengan beberapa helaian tipis jatuh alami membingkai sisi wajahnya. Ia memeluk...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat men...

​"Potret sinematik ultra-realistis close-up seorang anak laki-laki kecil (balita) yang sangat menggemaskan dengan mata cokelat besar yang ekspresif, rambut hitam berantakan yang tebal, mengenakan kaus putih kerah henley. Dia berpose dengan kedua tangan terkatup di depan dada, menunjukkan senyum...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tub...

Foto sinematik hiper-realistis resolusi tinggi menampilkan seorang pria muda Indonesia dengan tubuh ramping dan proporsional, rambut hitam pendek agak acak, mengenakan jaket kulit hitam, celana riding fit, dan sepatu motor. Ia sedang melakukan aksi freestyle ekstrem dengan motor sport 500cc...

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

•必填

完整撰写编辑后所需图像的说明文字,并按顺序标识参考对象,例如第一张或第二张图像。

•必填 image_urls
拖放文件,或 · 最多 10 个

用于编辑或合成的参考图像,最多 10 张。

image_size

输出尺寸默认采用第一张参考图像的尺寸;多个参考图像时上限为 1 百万像素,单个参考图像时缩放至最多 4 百万像素。明确指定的尺寸每边必须介于 256 和 4096 像素之间。

num_images 默认 1

请求生成的图像数量。

高级 output_format · seed · enable_prompt_expansion · enable_safety_checker · bounding_boxes
output_format 默认 png

结果图像的文件格式。

用于生成可复现图像的种子:模型版本不变时,相同的提示词和种子会生成相同图像。

可选对象布局,用于保留、移动、调整大小或移除参考对象,或放置新对象。坐标从每张图像左上角的 (0, 0) 开始;使用提示词中的标签引用框,例如 `<dragon>`。

POST /run/blackforestlabs/flux-3/klein/edit-image?wait=20 报价 → $0.009
# 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",
    "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://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 FLUX.3 Klein Image Editing

根据提示词和 `image_urls` 中的 1 到 10 张参考图编辑或合成图像,提示词可按顺序引用参考图,例如第一张图。最多 32 个 `bounding_boxes` 可用于保留、移动、调整大小、移除或添加对象,提示词通过标签命名对象。默认开启提示词扩展。返回 1 到 4 张 jpeg、png 或 webp 图像。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
prompt必填
类型string
完整撰写编辑后所需图像的说明文字,并按顺序标识参考对象,例如第一张或第二张图像。
enable_prompt_expansion可选
类型boolean
默认值true
生成前将提示词扩展为详细说明文字,值为 true 时启用。编辑时,说明文字基于参考图像生成。
seed可选
类型integer | null
用于生成可复现图像的种子:模型版本不变时,相同的提示词和种子会生成相同图像。
num_images可选 num_outputs
类型integer
默认值1
1 – 4
请求生成的图像数量。
enable_safety_checker可选
类型boolean
默认值true
安全检查器激活状态;true 启用检查。
output_format可选
类型enum
默认值png
jpegpngwebp
结果图像的文件格式。
image_urls必填 images
类型url[] · image
≤ 10 个项目
用于编辑或合成的参考图像,最多 10 张。
image_size可选
类型object
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
输出尺寸默认采用第一张参考图像的尺寸;多个参考图像时上限为 1 百万像素,单个参考图像时缩放至最多 4 百万像素。明确指定的尺寸每边必须介于 256 和 4096 像素之间。
bounding_boxes可选
类型object[]
≤ 32 个项目
可选对象布局,用于保留、移动、调整大小或移除参考对象,或放置新对象。坐标从每张图像左上角的 (0, 0) 开始;使用提示词中的标签引用框,例如 `<dragon>`。
bounding_boxes[].label可选
类型string | null
≤ 64 characters
框的简短对象标签,例如 `dragon`;默认值为 `obj_<n>`。在提示词中加入 `<dragon>`,将相关文字与该框关联;提示词中未提及的框会添加到场景中。
bounding_boxes[].description必填
类型string
≤ 500 characters
要在框内渲染的对象,包括其外观。
bounding_boxes[].box可选
类型object
对象的输出位置,替换 `source_box`/`target_box`,并使用与文生图相同的位置行为。
bounding_boxes[].box.x_min必填
类型number
0 – 1
相对于图像宽度表示的左边界,范围为 0 到 1。
bounding_boxes[].box.y_min必填
类型number
0 – 1
相对于图像高度表示的上边界,范围为 0 到 1。
bounding_boxes[].box.x_max必填
类型number
0 – 1
相对于图像宽度表示的右边界,范围为 0 到 1。
bounding_boxes[].box.y_max必填
类型number
0 – 1
相对于图像高度表示的下边界,范围为 0 到 1。
bounding_boxes[].source_image_index可选
类型integer | null
≥ 0
对象源选择:省略表示新对象,或通过其在 `image_urls` 中的索引标识现有参考对象,索引从 0 开始。
bounding_boxes[].source_box可选
类型object
对象在参考图像中的位置;还必须提供 `source_image_index`。
bounding_boxes[].source_box.x_min必填
类型number
0 – 1
相对于图像宽度表示的左边界,范围为 0 到 1。
bounding_boxes[].source_box.y_min必填
类型number
0 – 1
相对于图像高度表示的上边界,范围为 0 到 1。
bounding_boxes[].source_box.x_max必填
类型number
0 – 1
相对于图像宽度表示的右边界,范围为 0 到 1。
bounding_boxes[].source_box.y_max必填
类型number
0 – 1
相对于图像高度表示的下边界,范围为 0 到 1。
bounding_boxes[].target_box可选
类型object
对象的输出位置框:移动或调整大小需要同时提供两个框;移除参考对象时必须不设置此框。
bounding_boxes[].target_box.x_min必填
类型number
0 – 1
相对于图像宽度表示的左边界,范围为 0 到 1。
bounding_boxes[].target_box.y_min必填
类型number
0 – 1
相对于图像高度表示的上边界,范围为 0 到 1。
bounding_boxes[].target_box.x_max必填
类型number
0 – 1
相对于图像宽度表示的右边界,范围为 0 到 1。
bounding_boxes[].target_box.y_max必填
类型number
0 – 1
相对于图像高度表示的下边界,范围为 0 到 1。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "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"
  }
}
你的文件,由你选择每个 outputs[].url 都是存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
每个模型的结构相同图像、视频和音频均包含 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
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图像生成期间使用的提示词。

更多模型:图像编辑

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/blackforestlabs/flux-3/klein/edit-image.md. 所有模型和指南: https://doitong.com/developers/llms.txt