跳转到主要内容
Venice 上的图像编辑是同步的。将源图像发送到 /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”。 请求:
响应(200): 响应体是原始的 image/png 二进制数据。直接保存为文件即可。

第 2 步:使用 multi-edit 进行遮罩或分层 inpainting

/image/multi-edit 接受最多三张图像。第一张是基础图像。其余被视为编辑层或遮罩,比仅 prompt 编辑提供更多控制。 当您想要以下场景时,这是更好的选择:
  • 用遮罩定位特定区域
  • 将现有构图与叠加层组合
  • 比单图像 prompt 更严格地约束编辑
JSON 请求:
Multipart 请求:
/image/edit 一样,响应体是原始的 image/png 数据。
/image/multi-edit 目前在请求 schema 中使用 modelId 字段,而非 model

Inpainting 技巧

基于 prompt 的 inpainting 在指令简短且局部时效果最好:
  • remove the tree
  • change the sky to sunset
  • replace the logo with a blank sign
  • restore 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。其他具备编辑能力的模型可能有不同的定价和限制。 请参阅:

错误

某些编辑模型的内容政策比图像生成模型更严格。例如,qwen-edit 会拒绝涉及露骨色情图像、性化未成年人或真实暴力的请求。

相关工作流