跳转到内容

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-CN/developers/models/blackforestlabs/flux-3/klein/edit-image.md. 所有模型和指南: https://doitong.com/developers/llms.txt