Bria

FIBO 2.0

fibo-2.0/image-to-image

Bria 推出的统一图像模型，在同一模型内完成文生图与指令式图像编辑，编辑时最多可输入四张图片；仅用授权数据训练，适合概念美术、营销静帧与电商产品图

fibo-2.0/image-to-image fibo-2.0/text-to-image

试用 fibo-2.0/image-to-image

输入

作品灵感

查看全部作品

输出

image

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

价格

fibo-2.0/image-to-image 每张

单价	$0.0572

定位简介

该图生图模型支持以一张待编辑图片为基础，配合最多三张参考图和自然语言指令完成图像修改或合成。提示词最多10000字符，可用<image_1>等序号指代输入图片；输出约为一百万像素，宽高比可在二十一种预设中择一指定。适合需要按指令定向调整画面、融合多张素材并控制构图比例的设计师与开发者用于概念迭代、营销素材制作等场景。

核心亮点

指令驱动多图编辑与合成——以一张待编辑图为主，可附加最多三张参考图，用序号在指令中引用，完成局部修改或多图融合。
输出比例灵活可选——提供二十一种宽高比预设，多图输入时可按需指定输出比例，单图编辑则保留原图比例。
种子控制结果可复现——传入0到2147483647之间的随机种子，相同种子与相同输入可得到一致输出，便于A/B对比。
蒙版限定局部编辑范围——可选蒙版图指定编辑区域，白色区域修改、黑色区域保留，仅限单图编辑且蒙版需与原图尺寸一致。

能力说明

多图指令编辑与合成：输入1至4张公开图片URL，第一张为待编辑图，其余最多三张为参考图；指令中可用<image_1>、<image_2>等按顺序引用各图，实现局部修改或跨图元素融合。

蒙版约束局部修改：提供蒙版图时仅限单图编辑（image_urls只能包含1张），白色区域为待修改区、黑色区域保留；蒙版尺寸须与原图一致，适合精确局部替换。

输出比例按需指定：多图输入时可从1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、16:10、10:16、2:1、1:2、21:9、9:21、3:1、1:3、4:1、1:4、5:1、1:5中择一设定输出宽高比；单图编辑始终保留原图比例。

指令字符容量充足：提示词最多10000字符，可详细描述修改要求，结合图片序号引用多张输入素材，便于表达复杂的编辑指令。

种子复现编辑结果：通过seed参数固定随机种子，相同种子与相同输入可复现同一结果，方便在同一编辑任务上做参数对比或版本回溯。

适用场景

设计师定向修改概念图——输入一张概念设计图并附上修改指令，指定需调整的局部或属性，输出修改后的图像用于方案迭代与评审展示。
电商场景多图合成——以产品图为主图，搭配最多三张场景或风格参考图，通过指令融合生成生活方式场景图，用于商品详情页或广告素材。
营销素材比例适配——多图输入时指定1:1、16:9或9:16等输出比例，快速生成适配不同投放位的营销静帧，减少二次裁剪。
蒙版精确局部替换——对单张图片提供蒙版，仅修改白色标记区域，保留其余画面内容，适合替换产品局部或去除不需要的元素。

限制与选型建议

每次请求最多输入4张图片，单图编辑配蒙版时仅支持1张图片；蒙版尺寸必须与原图一致。提示词最长10000字符，超出无法提交。输出宽高比只能从预置的21种比例中选择一种，单图编辑固定沿用原图比例，无法另行指定。种子仅保证相同输入下的可复现性，不承诺跨参数组合的结果一致。

近期更新

查看更新日志 →

模型上新 FIBO 2.0 图片编辑上线 Nov 12, 2026
模型上新 FIBO 2.0 文生图上线 Nov 12, 2026

常见问题

查看全部常见问题 →

想要固定构图复现同一张图，怎么设？

固定 seed 并保持提示词不变即可复现同一结果。seed 默认 5555，取值范围 0 到 2147483647；只要 seed 与提示词一致，输出就一致，换 seed 则得到同题不同构图。
宽高比能选哪些？分辨率多大？

按构图从预设里挑一个宽高比，输出约为 1 兆像素。可选值包括 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、16:10、10:16、2:1、1:2、21:9、9:21，以及 3:1、1:3、4:1、1:4、5:1、1:5 等长条比例；不传时默认 1:1。
文生图的参考图和风格预设能一起用吗？

不能同时使用，二者只能选其一。文生图里传了 style 就不能再传 image_url，反之亦然；想要参考图定场景就放弃风格预设，想要胶片、硬闪、朦胧或粗粝真实感就只用文字提示词。图生图编辑没有风格预设参数，画面调性直接写在 instruction 里。
文生图有哪些摄影风格预设可选？

文生图支持四种摄影观感：Kodak Film、Hard Flash、Hazy Dreamy、Rough Realism。它只作为可选的整体照片调性，与参考图互斥；需要精确控制光照与机位时，仍应在提示词里写明，而不是只依赖预设。图生图编辑不提供风格预设。

提交生成任务

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必填

当前固定值：fibo-2.0/image-to-image

routestring可选

当前固定值：default

inputobject必填

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

seedinteger可选默认值: 5555min 0max 2147483647

随机种子，默认 5555。相同种子与相同输入可复现一致结果。

mask_urlstring可选minLength 1pattern ^https?://

可选的蒙版图像 URL，仅支持单图编辑，即 image_urls 必须恰好包含 1 张图片；白色区域为待编辑部分，黑色区域保持原样，且蒙版尺寸须与图像一致。

image_urlsarray必填minItems 1maxItems 4

图片 URL 数组，包含 1–4 个公开图片地址：第一张为待编辑图像，其后最多 3 张为参考图；指令中可按此顺序以 <image_1>、<image_2> 等引用。

Array [ string ]

instructionstring必填minLength 1maxLength 10000

对图像需要修改内容的文字指令。

aspect_ratiostring可选

输出宽高比，约一百万像素；省略时跟随第一张图片，单图编辑始终保留该图片的宽高比。

可选项：1:12:33:23:44:34:55:49:16

显示全部（13 项）收起

16:916:1010:162:11:221:99:213:11:34:11:45:11:5

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": "fibo-2.0/image-to-image",
  "input": {
    "seed": 5555,
    "image_urls": "…",
    "instruction": "…"
  }
}'

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: "fibo-2.0/image-to-image",
    input: {
      "seed": 5555,
      "image_urls": "…",
      "instruction": "…"
    }
  }),
});
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": "fibo-2.0/image-to-image",
        "input": {
          "seed": 5555,
          "image_urls": "…",
          "instruction": "…"
        }
    },
)
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"
    }
  }
}