/image/edit 或 /image/multi-edit,编辑后的结果会在同一响应中以 PNG 文件形式返回。对于抠图,/image/background-remove 返回透明 PNG。
端点
何时使用哪个端点
- 当您有一张源图像并希望用 prompt 改变、移除或重新风格化其部分时,使用
/image/edit。 - 当您需要从遮罩、叠加或参考层获得额外控制时,使用
/image/multi-edit。 - 当您只想要一个干净的、透明背景的前景主体时,使用
/image/background-remove。
对于 inpainting,请使用
/image/edit 或 /image/multi-edit。/image/generate 上旧的 inpaint 参数已弃用。第 1 步:编辑单张图像
单图像编辑是最简单的 inpainting 流程。发送一张图像加一个简短 prompt,例如 “remove the sign”、“change the sky to sunrise” 或 “replace the background with a studio backdrop”。 请求:image/png 二进制数据。直接保存为文件即可。
第 2 步:使用 multi-edit 进行遮罩或分层 inpainting
/image/multi-edit 接受最多三张图像。第一张是基础图像。其余被视为编辑层或遮罩,比仅 prompt 编辑提供更多控制。
当您想要以下场景时,这是更好的选择:
- 用遮罩定位特定区域
- 将现有构图与叠加层组合
- 比单图像 prompt 更严格地约束编辑
/image/edit 一样,响应体是原始的 image/png 数据。
/image/multi-edit 目前在请求 schema 中使用 modelId 字段,而非 model。Inpainting 技巧
基于 prompt 的 inpainting 在指令简短且局部时效果最好:remove the treechange the sky to sunsetreplace the logo with a blank signrestore the torn corner of the photo
/image/edit 切换到 /image/multi-edit 并提供遮罩或叠加层。
第 3 步:移除背景
当您希望前景主体在透明背景上单独显示时,请使用/image/background-remove。此端点返回带 alpha 透明度的 PNG。
使用图像 URL:
- 电商产品照片
- 个人资料照片和人像
- 您打算放在新背景上的素材
请求参数
/image/edit
/image/multi-edit
/image/background-remove
支持的输入格式
对于编辑端点,图像尺寸必须至少为
65536 像素且不超过 33177600 像素。上传文件必须小于 25MB。
模型和定价
默认编辑模型是qwen-edit,价格为每次编辑 $0.04。其他具备编辑能力的模型可能有不同的定价和限制。
请参阅:
- 图像定价
- 带有
type=inpaint的 Models API
错误
某些编辑模型的内容政策比图像生成模型更严格。例如,
qwen-edit 会拒绝涉及露骨色情图像、性化未成年人或真实暴力的请求。相关工作流
- 如果您从文本而非现有图像开始,请使用图像生成。
- 使用图像模型比较生成、编辑和增强模型家族。
- 使用 Image Edit API、Multi-Edit API 和 Background Remove API 了解完整 schema 细节。