FLUX 3 Image Klein API 指南：五档分辨率价格、参数与调用示例

FLUX 3 Image Klein 是什么

FLUX 3 Image Klein 是 Black Forest Labs FLUX 3 系列里的轻量图像模型。在 HiAPI 上只有一个模型 ID：flux-3-image-klein，文字生成图片和参考图编辑都用它。只写提示词就是文生图；再加上 image_urls，就是按参考图改画面、或者把几张图的风格融到一起。

它的长处是便宜、档位多：从 768 到 4K 共五档分辨率，适合批量出图和先小图试稿、再大图定稿的流程。

价格：按分辨率档位，每张计费

• 768：$0.0092 / 张
• 1K（默认）：$0.0103 / 张
• 1.5K：$0.0126 / 张
• 2K：$0.016 / 张
• 4K：$0.0412 / 张

参考图不另收费，带 1 张和带 10 张同价。steps 调低也不会便宜，价格只看 resolution。任务失败会全额退还。

举个例子：用 768 档试 50 张风格稿是 $0.46，挑出 5 张用 4K 出终稿是 $0.206。

参数

除 model 和 prompt 外都是可选参数：

• prompt：必填，1–5000 字符。
• resolution：768、1K、1.5K、2K、4K，默认 1K。
• aspect_ratio：16 个可选值，包括 21:9、2:1、16:9、3:2、7:5、4:3、5:4、1:1、4:5、3:4、5:7、2:3、9:16、1:2、9:21 和 auto（默认）。
• image_urls：1–10 张公网可访问的参考图，不写就是纯文生图。
• steps：1–16，默认 16。步数越少出图越快，细节可能减少。
• seed：0–4294967295。固定种子后，同样的参数会尽量复现相近的结果；不写则随机。
• safety_tolerance：0–4，默认 2。数字越大审核越宽松。
• output_format：jpeg（默认）或 png。

请求示例

图像任务是异步的：先创建任务，再轮询结果。model 放顶层，其余参数放进 input。

文生图，2K、4:5 竖图，固定种子：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3-image-klein",
    "input": {
      "prompt": "一只陶瓷咖啡杯放在晨光照亮的木桌上，浅景深，暖色调，产品摄影",
      "resolution": "2K",
      "aspect_ratio": "4:5",
      "seed": 42
    }
  }'

这一张是 $0.016。

参考图编辑，两张图融合风格：

{
  "model": "flux-3-image-klein",
  "input": {
    "prompt": "保留第一张图里的建筑结构，用第二张图的水彩笔触和配色重新绘制",
    "image_urls": [
      "https://example.com/building.jpg",
      "https://example.com/watercolor.jpg"
    ],
    "resolution": "1.5K",
    "output_format": "png"
  }
}

创建成功后用返回的任务 ID 调 GET https://api.hiapi.ai/v1/tasks/{taskId} 轮询，成功后从输出里取图片地址。

用法建议

• 先小后大：用 768 或 1K 加固定 seed 试提示词，满意后只把 resolution 改成 2K 或 4K 再出一次。
• 批量变体：同一个提示词换不同的 seed，就是一组构图不同、风格一致的候选。
• 改图要写清楚保留什么：带参考图时，在提示词里说明哪些要保留、哪些要改，比只描述目标画面稳定。

当前限制

• 每次调用返回一张图。
• 参考图最多 10 张，必须是公网 http(s) 地址。
• 没有透明背景选项，png 只是换了一种无损格式。