Black Forest Labs

FLUX.2

flux-2/image-to-image

Black Forest Labs 的图像生成与编辑家族，支持基于参考图的风格迁移与多参考图融合，编辑时尽量保留原构图与主体位置

flux-2/image-to-image flux-2/text-to-image

试用 flux-2/image-to-image

输入

作品灵感

查看全部作品

输出

image

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

价格

flux-2/image-to-image 每张

规格	单价
1K	$0.035
2K	$0.050

定位简介

FLUX.2 图像编辑线路，接收 1 至 8 张参考图与一段编辑指令，在尽量保留原图构图与主体位置的前提下完成风格替换与细节调整。适合需要把已有素材改造成新视觉的开发者，例如风格迁移、多图融合与创意原型迭代。通过 HiAPI.ai 统一接口调用，输出图片分辨率可选 1K 或 2K，宽高比支持常见比例及跟随首图的 auto 模式。

核心亮点

编辑时优先保留原构图与主体位置——按指令改动风格与细节，而不是重新生成一张陌生画面，减少后续对齐成本。
单次可串联 1 至 8 张参考图——提示词中可按顺序引用图片，实现素材替换与多图元素融合。
输出比例与分辨率可控——可指定 1K 或 2K 与多种宽高比，auto 模式直接沿用首张输入图的构图。

能力说明

指令驱动的图像编辑：传入参考图与编辑指令即可得到修改后的图像，适合在既有素材上做定向调整，而非从零生成。

多图引用与元素组合：最多 8 张输入图，提示词可按序号引用各图，便于把一张图的元素放入另一张图的场景。

构图与比例的沿用：宽高比设为 auto 时匹配首张输入图，改动内容的同时保持原有版式，便于批量替换同尺寸素材。

分辨率可选输出：支持 1K 与 2K 两档输出分辨率，按终端展示需求选择，兼顾预览与成品用途。

适用场景

设计师对已有照片做风格迁移——输入原始照片与风格描述，得到保留主体位置的风格化版本，用于情绪板与方案初稿。
营销素材的元素替换——传入产品图与场景图，按指令替换画面内容，产出尺寸统一的广告图用于多渠道投放。
多参考图的风格统一——输入多张已有视觉素材，生成风格一致的衍生图，用于活动视觉的系列化扩展。

限制与选型建议

只支持图生图，至少需要一张参考图，不能纯文本出图；提示词限 3 至 5000 字符，输入图为 jpeg/png/webp 且单张不超过 10MB，不支持 SVG。分辨率仅 1K 与 2K 两档。需要从零构思画面时，应改用同家族文生图线路；对非商用许可或本地部署有要求的场景，需另行核实授权与部署条件。

近期更新

查看更新日志 →

模型上新新增模型：flux-2-klein-4b/text-to-image，支持 0.25-4 MP 分档的高性价比文生图；以… Jul 27, 2026
模型上新新增图像编辑模型：flux-2-klein-4b/image-to-image 支持单张参考图与 0.25-4 MP 输… Jul 27, 2026

常见问题

查看全部常见问题 →

FLUX.2 图片编辑支持多少张参考图？

支持 1 至 8 张 JPEG、PNG 或 WebP 参考图，每张不超过 10MB。多图合成时应在 Prompt 中按顺序说明每张图的角色。
auto 画幅有什么作用？

auto 会跟随第一张参考图的宽高比；需要固定横版、竖版或方形输出时可选择明确画幅。
1K 和 2K 如何计费？

1K 与 2K 使用不同的单张档位，参考图数量不另外加价；具体金额以本页实时价格为准。
如何减少主体和 Logo 漂移？

明确写出每张参考图的用途，并同时列出要改变和必须保留的主体、文字、材质、位置与光线。

提交生成任务

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/image-to-image

routestring可选

当前固定值：default

inputobject必填

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

promptstring必填minLength 3maxLength 5000

编辑指令，描述期望的输出效果，长度 3-5000 个字符。需按顺序引用输入图像，例如「将图像 1 中的罐子装入图像 2 中的胶囊」。

image_urlsarray必填minItems 1maxItems 8

输入参考图像数组，包含 1-8 张图像，每张为公开可访问的 URL，支持 jpeg/png/webp 格式，单张最大 10MB；不支持 SVG。

Array [ string ]

resolutionstring必填默认值: "1K"

输出图像分辨率，默认 1K。

可选项：1K2K

aspect_ratiostring必填默认值: "1:1"

生成图像的宽高比，默认 1:1；设为 auto 时匹配第一张输入图像的宽高比。

可选项：1:14:33:416:99:163:22:3auto

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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }
}'

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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1"
    }
  }),
});
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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}