FLUX.1 Fill Pro API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | flux-1-fill-pro |
|---|---|
| 类型 | 图像编辑（蒙版局部重绘） |
| 接口 | POST /v1/tasks |
| 价格 | 见 HiAPI 定价 |
FLUX.1 Fill Pro：上传原图和黑白蒙版，只重绘白色区域，黑色区域保持不变，适合商品修饰、背景替换与局部补全。
生产建议
生产环境建议
- 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
- GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
- 产物 URL 有有效期，拿到结果后请及时转存到自己的存储。
适用场景
商品局部修饰
只替换商品的一个区域，保留包装文字、主体形状和摄影棚光线。
imagemaskprompt背景替换与移除
用蒙版圈出背景或杂物，让提示词补全新画面，主体保持不动。
maskprompt局部改造
更换墙面装饰、桌面材质或地面纹理，保留房间布局和光线方向。
imagemask请求参数
model string 必填 固定填 flux-1-fill-pro。
input object 必填 业务参数对象。
image string 必填 原图 URL（http/https），支持 JPEG、PNG、GIF、WebP。使用蒙版时，原图与蒙版尺寸必须一致。
mask string 必填 黑白蒙版 URL：黑色区域保留原图，白色区域由提示词重绘；尺寸必须与原图一致。支持 JPEG、PNG、GIF、WebP。
prompt string 必填 描述蒙版白色区域要生成或替换的内容，最多 4000 个字符。
steps integer 可选 扩散步数，15–50；数值越高细节越精细，耗时也更长。
guidance number 可选 提示词引导强度，1.5–100；数值越高越贴近提示词，但可能降低画面自然度。
seed integer 可选 随机种子；固定种子并保持相同输入，可复现相近结果。
output_format enum 可选 输出图片格式。
prompt_upsampling boolean 可选 开启后自动改写提示词以增加创意；需要严格按原文生成时关闭。
callback object 可选 可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务。
url string 必填 传入 callback 时必填；接收任务终态通知的 HTTPS 地址。
when enum 可选 回调触发时机；当前建议固定为 final。
用例示例
用蒙版替换墙面
蒙版只覆盖挂钟所在墙面；提示词描述新画作，沙发、家具、地板和光线保持不变。
请求体
{
"model": "flux-1-fill-pro",
"input": {
"image": "https://dev-static.hiapi.ai/model-onboarding/flux-1-fill-pro/2026/10/19/2026/10/19/1792418738578-4e5072a121d7018f-source.jpg",
"mask": "https://dev-static.hiapi.ai/model-onboarding/flux-1-fill-pro/2026/10/19/2026/10/19/1792418739459-82bb18075f29c864-mask.png",
"prompt": "A large framed abstract painting in warm terracotta, sand and cream tones, hanging on the wall, with a thin dark wood frame; keep the room, sofa, furniture and lighting unchanged.",
"steps": 50,
"guidance": 60,
"output_format": "png",
"prompt_upsampling": false
}
}固定 seed 复现一个方向
在相同原图、蒙版和提示词下固定 seed，便于比较不同 steps 或 guidance 组合。
请求体
{
"model": "flux-1-fill-pro",
"input": {
"image": "https://dev-static.hiapi.ai/model-onboarding/flux-1-fill-pro/2026/10/19/2026/10/19/1792418738578-4e5072a121d7018f-source.jpg",
"mask": "https://dev-static.hiapi.ai/model-onboarding/flux-1-fill-pro/2026/10/19/2026/10/19/1792418739459-82bb18075f29c864-mask.png",
"prompt": "A large framed abstract painting in warm terracotta, sand and cream tones, hanging on the wall, with a thin dark wood frame; keep the room, sofa, furniture and lighting unchanged.",
"steps": 50,
"guidance": 60,
"output_format": "png",
"prompt_upsampling": false,
"seed": 12345
}
}获取结果
- 提交成功后立即返回 taskId，不等待生成完成。
- 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
- status=success 后，从返回的 output 中取图片地址并下载。
- 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。
常见问题
蒙版的黑白分别代表什么？
黑色区域保留原图，白色区域由提示词重绘；蒙版必须与原图尺寸一致。
image 和 mask 都必须上传吗？
是。当前公开接口要求同时提供原图和黑白蒙版，缺一不可。
提示词应该写什么？
只描述蒙版白色区域里要出现的新内容，并说明必须保留的元素；不要重复描述蒙版外的画面。
steps 和 guidance 怎么选？
steps 范围 15–50，默认 50；guidance 范围 1.5–100，默认 60。数值越高通常越精细、越贴近提示词，耗时也可能增加。
输出尺寸会跟随原图吗？
输出保持原图宽高比；实际像素以任务结果为准，本次 1600×900 原图得到 1440×810 结果。
支持哪些输入和输出格式？
原图和蒙版支持 JPEG、PNG、GIF、WebP；输出可选 jpg 或 png。
如何让结果更稳定？
固定 seed，并使用相同的原图、蒙版和提示词；调整 steps 或 guidance 可以改变细节和贴合度。
怎么计费？
按输出图片张数计费，每次请求返回 1 张；当前单价见实时价格页。