FLUX.2 [klein] 4B 图生图 API

POST /v1/tasks

所有模型都通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称	flux-2-klein-4b/image-to-image
类型	图像生成（图生图）
接口	POST /v1/tasks
价格	见 HiAPI 定价

FLUX.2 [klein] 4B 图生图 API：单图指令编辑、最高 4 MP 输出，按分辨率分档，适合低成本快速批量改图。

生产建议

生产环境建议

生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

批量商品图改版

保留商品主体，用自然语言替换背景、灯光与视觉风格，适合大批量素材生产。

image_urlsprompt

低成本快速迭代

4B 线路按输出分辨率分档，草稿可先用 0.25 MP 或 0.5 MP，定稿再升至 2 MP / 4 MP。

resolution

保留原图构图

使用 match_input_image 继承参考图比例，也可改成常见横竖版画幅。

aspect_ratio

可复现编辑

固定 seed，便于在相同输入和指令下对比参数变化。

seed

请求参数

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

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-2-klein-4b/image-to-image",
  "input": {
    "prompt": "Keep the subject and camera angle. Replace the background with a deep-blue studio gradient and add soft rim lighting.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/f35f947e46888163.png"
    ],
    "resolution": "2 MP",
    "aspect_ratio": "16:9",
    "seed": 20260727,
    "output_format": "png",
    "output_quality": 95
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "flux-2-klein-4b/image-to-image",
  "input": {
    "prompt": "Keep the subject and camera angle. Replace the background with a deep-blue studio gradient and add soft rim lighting.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/f35f947e46888163.png"
    ],
    "resolution": "2 MP",
    "aspect_ratio": "16:9",
    "seed": 20260727,
    "output_format": "png",
    "output_quality": 95
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "flux-2-klein-4b/image-to-image",
  "input": {
    "prompt": "Keep the subject and camera angle. Replace the background with a deep-blue studio gradient and add soft rim lighting.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/f35f947e46888163.png"
    ],
    "resolution": "2 MP",
    "aspect_ratio": "16:9",
    "seed": 20260727,
    "output_format": "png",
    "output_quality": 95
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

固定填 flux-2-klein-4b/image-to-image。

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

input object 必填

业务参数对象；FLUX.2 [klein] 4B Image to Image 的模型专属配置都放在这里。

prompt string 必填

描述希望对参考图执行的修改。尽量同时说明要保留的主体、构图与需要变化的内容。

image_urls string[] 必填

单张参考图 URL 数组。支持 jpeg/png/webp，不支持 svg；超过 4 MP 的输入会缩放到 4 MP。

resolution enum 可选

输出分辨率档位，也是本模型的计费分档。

默认 1 MP 可选值: 0.25 MP0.5 MP1 MP2 MP4 MP

aspect_ratio enum 可选

输出宽高比；match_input_image 表示沿用参考图比例。

默认 match_input_image 可选值: match_input_image1:116:99:163:22:34:33:45:44:521:99:21

seed integer 可选

随机种子；固定后便于复现和比较编辑结果。

output_format enum 可选

输出图片格式。

默认 jpg 可选值: webpjpgpng

output_quality integer 可选

jpg/webp 压缩质量，整数 0-100；PNG 通常不受影响。

默认 95

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback

when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

商业摄影棚背景替换（2 MP）

使用单张公开参考图，保留主体与视角，替换背景并增强轮廓光。

请求体

{
  "model": "flux-2-klein-4b/image-to-image",
  "input": {
    "prompt": "Keep the subject and camera angle. Replace the background with a deep-blue studio gradient and add soft rim lighting.",
    "image_urls": [
      "https://static.hiapi.ai/gallery/2026/07/f35f947e46888163.png"
    ],
    "resolution": "2 MP",
    "aspect_ratio": "16:9",
    "seed": 20260727,
    "output_format": "png",
    "output_quality": 95
  }
}

获取结果

提交成功后立即返回 taskId（不等待生成完成）。
生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
status=success 后，从返回的 output[].url 下载生成的图片。
如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

4B 图生图支持几张参考图？

HiAPI 当前开放单张参考图。这样可以让输入成本与分辨率分档保持可预测；image_urls 必须是只含一个公开图片 URL 的数组。

4B 图生图如何计费？

按输出分辨率分为 0.25 MP、0.5 MP、1 MP、2 MP、4 MP 五档。实际价格以 HiAPI 实时定价页为准。查看实时价格

什么时候选 4B，什么时候选 9B？

4B 更适合成本敏感、需要大量快速迭代的编辑；9B 更适合对细节保持、文字表现和最终画质要求更高的任务。

输入图片有什么限制？

支持 jpeg、png、webp，不支持 svg。超过 4 MP 的输入会缩放到 4 MP；建议使用稳定可公开访问的 HTTPS URL。