Black Forest Labs

FLUX.2 Klein 4B

flux-2-klein-4b/image-to-image

40 亿参数蒸馏小模型，统一文生图与图像编辑，端到端推理可低至 1 秒内，约 13GB 显存即可运行

flux-2-klein-4b/image-to-image flux-2-klein-4b/text-to-image

试用 flux-2-klein-4b/image-to-image

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

flux-2-klein-4b/image-to-image 每张

规格	单价
0.25 MP	$0.00608
0.5 MP	$0.00643
1 MP	$0.00715
2 MP	$0.00858
4 MP	$0.01143

定位简介

FLUX.2 klein 4B 是 Black Forest Labs 推出的 40 亿参数图像编辑模型，支持单张参考图输入，通过指令对原图进行受控修改。开发者可指定输出分辨率（0.25–4 MP）、宽高比、格式与压缩质量，并固定随机种子以复现结果。适合需要快速验证图像编辑流程的开发者，以及将参考图改绘接入应用原型的团队。

核心亮点

单参考图指令编辑——只需提供一张参考图与编辑提示词，即可完成对原图的定向修改，无需额外搭建编辑管线。
输出参数可精细控制——支持指定分辨率（0.25–4 MP）、宽高比、输出格式与压缩质量，并可用种子复现同一结果。
体积紧凑的蒸馏模型——4B 参数蒸馏自更大 FLUX.2 基座，在保持对光照与材质理解的同时降低部署门槛。

能力说明

指令式图像编辑：输入一张参考图与提示词，模型按描述对参考图执行修改，输出可直接用于下游流程的编辑结果。

输出分辨率与比例控制：分辨率可在 0.25 MP 至 4 MP 间选择，宽高比支持匹配原图或指定常见比例，满足不同展示位要求。

格式与质量可调：支持 webp、jpg、png 输出，并可设置压缩质量（0–100），便于在画质与文件体积间取舍。

结果可复现：通过设置 seed 参数，可在相同输入下复现同一编辑结果，便于调试与批量任务的一致性验证。

适用场景

开发者快速验证图像编辑流程——用单张参考图加提示词测试编辑效果，产出可复现的样例图，用于评估是否接入生产管线。
产品图风格一致性改绘——以产品参考图为基础，按指令调整风格或细节，输出统一规格的图片用于展示或素材库。
实时交互式编辑原型——在交互式工具中集成参考图改绘能力，输出低至 0.25 MP 的预览图供即时反馈。

限制与选型建议

仅接受单张参考图，无法同时约束多张图像；输入图超过 4 MP 会被压缩至 4 MP，且不支持 SVG 格式。作为 4B 蒸馏小模型，能力上限受规模约束，复杂编辑或细节还原要求高的场景建议评估更大模型。当前缺少独立横向基准数据，商用前需核对完整许可与用途说明。

常见问题

查看全部常见问题 →

FLUX.2 [klein] 4B 适合哪些任务？

适合批量草稿、商品概念、社交媒体素材和成本敏感的视觉迭代。需要更强写实、文字和细节时可改用 9B。
0.25 MP 到 4 MP 如何选择？

草稿和缩略图可先用 0.25 或 0.5 MP；常规网页素材使用 1 MP；需要更大输出时选择 2 或 4 MP。价格随像素档位变化。
支持哪些画幅？

支持 1:1、16:9、9:16、3:2、2:3、4:3、3:4、5:4、4:5、21:9 和 9:21。
如何复现同一构图方向？

固定 Seed、Prompt、画幅、像素档位和输出设置；只修改一个变量进行对比。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：flux-2-klein-4b/image-to-image

routestring可选

当前固定值：default

inputobject必填

flux-2-klein-4b/image-to-image 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选

随机种子，用于控制生成结果的可复现性；取整数，相同种子在同一输入下可得到一致结果。

promptstring必填

提示词，描述要对参考图像执行的编辑内容；取字符串。

image_urlsarray必填minItems 1maxItems 1

参考图像数组，元素为单张参考图像的 URL；支持 jpeg、png、webp 格式，不支持 svg，超过 4 MP 的图像会被压缩至 4 MP。

Array [ string ]

resolutionstring可选默认值: "1 MP"

输出图像分辨率，以百万像素为单位指定输出尺寸；默认 1 MP。

可选项：0.25 MP0.5 MP1 MP2 MP4 MP

aspect_ratiostring可选默认值: "match_input_image"

输出图像的宽高比；设为 match_input_image 时保持参考图像的原始比例，默认 match_input_image。

可选项：match_input_image1:116:99:163:22:34:33:4

显示全部（4 项）

5:44:521:99:21

output_formatstring可选默认值: "jpg"

生成图像的输出格式；默认 jpg。

可选项：webpjpgpng

output_qualityinteger可选默认值: 95min 0max 100

输出图像压缩质量，仅对 jpg 和 webp 格式生效；取整数，默认 95。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-klein-4b/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1 MP",
    "aspect_ratio": "match_input_image",
    "output_format": "jpg",
    "output_quality": 95
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-2-klein-4b/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1 MP",
      "aspect_ratio": "match_input_image",
      "output_format": "jpg",
      "output_quality": 95
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-2-klein-4b/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1 MP",
          "aspect_ratio": "match_input_image",
          "output_format": "jpg",
          "output_quality": 95
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}