跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

FIBO Edit 1.5 Image Editing API

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

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 fibo-edit-1.5/image-to-image
类型 图像编辑（图生图）
接口 POST /v1/tasks
价格 见 HiAPI 定价

FIBO Edit 1.5：用一句话修改图片，可同时参考最多 4 张图做合成、试穿或换背景，也能用蒙版只改局部。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • 产物 URL 有有效期，拿到结果后请及时转存到自己的存储。

适用场景

服装试穿与商品合成

人物图加服装图、商品图加场景图，一句话合成。

image_urlsinstructionaspect_ratio
局部替换

用蒙版只改地面、背景或某个物体。

mask_url
改色与换风格

改颜色、换季节或氛围，保留结构和细节。

instruction

请求参数

model string 必填

固定填 fibo-edit-1.5/image-to-image。

示例 fibo-edit-1.5/image-to-image
input object 必填

业务参数对象。

image_urls string[] 必填

1–4 张图片的公网 URL（http/https）。顺序有意义，指令里的“图 1、图 2”按这个顺序对应。

instruction string 必填

编辑指令，说明要改什么、保留什么。

aspect_ratio enum 可选

输出比例，仅在 2 张及以上图片时生效；不填时跟随第一张图。只有 1 张图时输出保持原图比例。

可选值: 1:12:33:23:44:34:55:49:1616:9
mask_url string 可选

可选蒙版图 URL，仅单图编辑可用：白色为要修改的区域，黑色保持不变，尺寸须与原图一致。

seed integer 可选

随机种子，相同种子和输入会得到相同结果。

默认 5555
callback object 可选

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

url string 必填

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

示例 https://your-domain.com/hiapi/callback
when enum 可选

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

默认 final 可选值: final

用例示例

两图合成：服装试穿

把图 2 的灯芯绒外套穿到图 1 的人物身上，姿势、面部和背景保持不变。

请求体
{
  "model": "fibo-edit-1.5/image-to-image",
  "input": {
    "image_urls": [
      "https://dev-static.hiapi.ai/model-onboarding/fibo-edit-1.5/2026/10/16/1792150791858-9ed857b3db0a2f7c-i1-model.jpg",
      "https://dev-static.hiapi.ai/model-onboarding/fibo-edit-1.5/2026/10/16/1792150835692-61b39dc0f55655a0-i2-jacket.jpg"
    ],
    "instruction": "Dress the woman in image 1 with the mustard corduroy jacket from image 2, worn open over her white t-shirt. Keep her pose, face and the studio background.",
    "aspect_ratio": "3:4"
  }
}

获取结果

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

常见问题

FIBO Edit 1.5 能做哪些编辑？

改颜色、换背景、换季节或风格、局部替换，以及把多张图合成到一起，例如服装试穿或商品放进场景。

最多能传几张图？

image_urls 支持 1–4 张。顺序有意义，指令里的“图 1、图 2”按这个顺序对应。

aspect_ratio 什么时候生效？

只有 2 张及以上图片时生效；不填时跟随第一张图。只有 1 张图时输出保持原图比例，在线 Playground 也只在上传 2 张以上时显示比例选项。

蒙版怎么用？

mask_url 只能用于单图编辑，白色为要修改的区域，黑色保持不变，尺寸必须与原图一致。

输出是什么格式？

每次返回 1 张 PNG 图片，通过任务结果里的 output[].url 下载。

为什么同样的输入结果一样？

seed 默认是 5555，相同的种子和输入会得到相同结果。换一个 seed 即可得到不同结果。

没有原图时用哪个模型？

从文字直接生成图片请使用 FIBO Gen 1.5。

下一步