文生图 · 参考图编辑 · 最高 4K ● 可用

FLUX 3 Image API

Roko API 的 flux-3-image 当前通过 Kie AI 接入 FLUX 3 Klein：不传参考图时文生图，传图时自动切换图片编辑。支持 1K、2K、4K，以及每次 1–4 张输出。

获取 API Key 查看完整 API 文档

公开模型 ID: flux-3-image
输出档位: 1K / 2K / 4K（默认 1K）
计费方式: 按生成图片数量与所选分辨率
生成接口: POST /v1/images/tasks
目录快照: 2026/11/13 06:05:03

FLUX 3 Image 是什么？

当前公开 ID flux-3-image 对应 Kie AI 的 FLUX 3 Klein 接入，不代表 BFL 完整版 FLUX 3 Image 的全部能力。

客户端保持同一个模型 ID：没有参考图时生成新图，传入 1–10 张公网图片 URL 时自动编辑或组合参考内容。

输出分辨率为 1K、2K、4K，每次可请求 1–4 张。使用异步任务提交与查询，费用取决于分辨率和实际成功输出数量。

核心能力

文生图

用提示词描述主体、背景和风格，无需切换上游模型。

参考图编辑

提供 1–10 张参考图，并说明要修改和保留的内容；结果需人工复核。

批量输出

n 可设为 1–4，按实际成功输出数量结算。

三档分辨率

选择 1K、2K 或 4K，并使用当前支持的画幅比例。

FLUX 3 Image API 价格

价格由当前 Roko 模型目录生成，按生成图片数量与所选分辨率计费。核验时数值恰与 Kie AI 标准价一致，但上游价格与促销不决定 Roko 结算；请以任务提交时的 Roko 估价和最终账单为准。

分辨率	价格	计费单位
1k	$0.01	每张输出
2k	$0.016	每张输出
4k	$0.036	每张输出

费用怎么算？

生成 1 张 1K 图1 × $0.008 = $0.008

默认档位，网页与社媒素材的标准成本。

1 张 4K 输出1 × $0.0325 = $0.0325

按实际成功张数结算；此为当前价格快照的计算示例。

参数与支持范围

以下参数来自当前 Kie 接入配置。参考图仅接受公网 HTTP / HTTPS URL；不提供专用边界框布局、grounding 或 safety_tolerance 参数。

参数	可用值	说明
`prompt`	textarea	描述要生成的画面，或说明要对参考图做哪些修改。 · 必填
`images`	url · 1–10	仅支持公网 HTTP / HTTPS 图片 URL，最多 10 张；不接受 Base64 或浏览器 blob: 地址。 · 可选
`aspect_ratio`	auto / 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 9:21	编辑时 auto 跟随参考图；文生图省略或传 auto 时使用 1:1。 · 默认: auto · 可选
`resolution`	1k / 2k / 4k	选择当前模型配置的输出分辨率档位；该值可能直接影响价格。 · 默认: 1k · 可选
`n`	1–4	一次请求生成的图片数量；数量越多费用越高。 · 默认: 1 · 可选
`output_format`	png / jpeg / webp	生成图片的文件格式，可选 png 或 jpeg。 · 默认: png · 可选
`enhance_prompt`	boolean	可选
`seed`	integer	可选

用 Roko API 调用 FLUX 3 Image

走异步任务流程：提交任务拿到 task_id，再轮询查询结果。不要在前端代码中暴露 API Key。

发起图片生成

curl https://api.rokoapi.com/v1/images/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "flux-3-image",
  "prompt": "A ceramic mug on a white studio background, soft side lighting.",
  "aspect_ratio": "16:9",
  "resolution": "2k"
}'

查询恢复任务

curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
  -H "Authorization: Bearer $API_KEY"

POST /v1/images/tasks 返回 202 与 task_id，生成完成后通过 GET /v1/tasks/{task_id} 查询结果或失败原因。Idempotency-Key 需唯一；相同 Key 的重放会返回原任务而不重复计费。

适合哪些场景？

产品场景草图

描述产品、灯光和背景，先用 1K 检查构图。

A ceramic mug on a white studio background, soft side lighting.

背景与颜色修改

提供参考图并明确要修改和保留的内容；不要假定其余区域像素完全不变。

Change the mug to blue while keeping its shape and the white background.

多参考图组合

说明各张参考图提供的主体、风格或场景信息。

Use the product from image 1 and the background from image 2.

多版本探索

使用 n 请求最多 4 张结果，再人工选择合适版本。

Create alternative studio compositions of a ceramic mug.

使用前要知道的限制

参考图为 1–10 张公网 HTTP / HTTPS URL；不支持 Base64、Data URL 或 blob: 地址。
支持 9 种固定宽高比；编辑可用 auto，文生图省略或传 auto 时使用 1:1。
当前接入是 FLUX 3 Klein，不承诺像素级局部保持，也未开放完整版特有的布局控制和联网检索参数。
提交成功只表示受理；必须查询至终态，并检查图片是否符合用途。

FLUX 3 Image 与其他图像模型怎么选？

按实际任务、参考图限制、分辨率和当前目录价格选择模型；本页未进行同条件效果或速度比较。

全部模型 →

FLUX 3 Image 常见问题

FLUX 3 Image API 的模型 ID 是什么？

Roko API 当前公开模型 ID 是 flux-3-image。请原样传入 model 字段。

FLUX 3 Image API 多少钱？

按生成图片数量与所选分辨率计费：1K $0.008、2K $0.0125、4K $0.0325。核验时数值与 Kie AI 标准价相同，但 Roko 结算以任务提交时的项目估价和最终账单为准。

文生图和图片编辑要切换模型 ID 吗？

不需要。保持 flux-3-image，不传参考图为文生图，传图后自动选择编辑模型。

参考图如何传入？

使用 image_urls 或 images 提供 1–10 张公网 HTTP / HTTPS 图片 URL；也兼容 image 和 input_reference。

支持哪些分辨率和宽高比？

分辨率为 1K、2K、4K；固定比例为 1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、9:21。编辑可用 auto，文生图的 auto 使用 1:1。

FLUX 3 Image 通过哪个接口调用？

通过 POST /v1/images/tasks 提交异步任务并拿到 task_id，再用 GET /v1/tasks/{task_id} 轮询结果或失败原因。

这是 BFL 完整版 API 吗？

当前通过 Kie AI 接入 FLUX 3 Klein，未开放专用边界框布局和联网检索参数，不能据此推断完整版能力。

一次可以生成几张图片？

n 为 1–4，默认 1；按实际成功输出张数和所选分辨率结算。