Qwen Image 2.1 Edit API

alibaba/qwen-image-2.1/edit
1K / 2K · 6 / 10 credits

Qwen Image 2.1 Edit 将 1–10 张参考图与指令转化为高精度编辑图像,支持多图特征融合与遮罩局部重绘。它精准保持人物五官轮廓与商品材质,实现自然的背景置换与非遮罩像素完整保留。

获取 API Key
输入
1192 / 5,000

拖拽文件、粘贴剪贴板素材,或输入 URL。 按顺序添加 1–10 张图片。支持 JPEG、PNG、WebP,每张最多 30 MB、25 MP。

2/10 个素材

拖拽文件、粘贴剪贴板素材,或输入 URL。 需恰好一张参考图且背景为 opaque。白色区域修改,黑色区域保留。遮罩应与参考图比例一致。

输出已就绪
6 credits / 张 · $0.030

继续使用

示例

The First Chair Repaired After the Flood

Repair only the damaged oak chair inside the white area of the supplied mask. Replace the broken seat plank with a structurally complete oak plank and mend the snapped upper backrest rail so the same chair is whole, stable and usable again. Match the existing oak color, aged wood grain, joinery, perspective and soft window lighting; keep the chair's original design and position. Retain subtle signs of age rather than making it a new manufactured chair. Preserve every pixel in the black mask area: the elderly carpenter, face, blue apron, workbench, tools, window, walls, mud marks and floor outside the chair region must remain unchanged. The image tells the story of the first small repair after the flood. Do not add people, objects, text, logos, brands or watermark.

The Seaside Kite, Ready for a Memory Book

This is an RGBA image with transparency. Extract only the exact handmade swallowtail kite from image 1 as a transparent cutout, including both complete long ribbon tails and the thin curled kite string. Preserve the original swallowtail outline, pale turquoise rice-paper panels, muted vermilion edging, fine bamboo ribs, ivory repair patch on the left wing, paper fibers, knots, colors, scale and lighting. Preserve fine gaps between string, ribbons and kite; retain the subtly translucent quality of thin rice paper where appropriate. Remove the wooden peg, cottage eave, plaster wall, sea and every other background element. Keep the entire original kite, tails and curled string within the output frame without cropping, stretching, redesigning or adding anything. Real alpha transparency, no colored backdrop, floor, cast shadow outside the kite or drawn checkerboard. This is a keepsake from a seaside flight, not a product advertisement. No text, brand, logo or watermark. The background is transparent.

Qwen Image 2.1 Edit

Qwen Image 2.1 Edit 是阿里巴巴通义团队研发的统一图像编辑模型。通过 Qwen3-VL 联合编码与 Prefix KV 缓存技术,它在 7B 底座上支持多达 10 张参考图特征融合、单图遮罩局部重绘与 RGBA 透明图层编辑。该模型为电商虚拟试穿、商品二次设计与主体免抠提取提供了工业级编辑能力。

为什么选择 Qwen Image 2.1 Edit?

  • 支持 1–10 张多参考图的强大混合与融合能力允许一次性输入最多 10 张参考图片,可将模特肖像、服装版型、配饰单品与环境背景自然组合,轻松完成电商跨图虚拟试穿与多主体同框合成。

  • 精准的遮罩局部重绘与非破坏性像素保留支持配合单张参考图传入 Mask Url 黑白蒙版,白色修改区域精准重绘,黑色保留区域百分之百锁定原始像素,杜绝全局形变干扰。

  • 卓越的主体身份特征与商品质感一致性基于 Qwen3-VL 统一视觉语言表征,深度记忆人物面容轮廓、五官比例、服饰图案与商品材质纹理,在复杂编辑与风格迁移中保持高度一致。

  • 原生透明 RGBA 图层提取与免抠编辑内置 64 通道 RGBA 自编码器,能够直接从常规 RGB 摄影原图中精确剥离出带透明通道的独立主体图层,实现工业级透明贴纸与免抠素材二次编辑。

  • Prefix KV 缓存加速多图推理,多图与遮罩零附加费通过前缀键值缓存(Prefix KV Cache)显著优化多参考图去噪计算耗时,且计费仅按输出分辨率结算,上传多张参考图或遮罩不收取任何额外费用。

参数

参数要求说明
prompt必填

必填非空文本,去除首尾空白后最多 5,000 个字符。

image_urls必填

按顺序添加 1–10 张图片。支持 JPEG、PNG、WebP,每张最多 30 MB、25 MP。

mask_url可选

需恰好一张参考图且背景为 opaque。白色区域修改,黑色区域保留。遮罩应与参考图比例一致。使用遮罩时忽略 size 和 prompt_extend。

size可选

选择支持的比例。Edit 默认 auto,生成默认 1:1。使用遮罩时忽略。

默认auto1:14:33:43:22:316:99:1621:99:21
resolution可选

1K:6 积分($0.030);2K:10 积分($0.050)。

默认1K2K
output_format可选

支持 png、jpeg、webp。透明背景需使用 png 或 webp。

默认pngjpegwebp
background可选

支持 opaque、transparent。使用遮罩时需为 opaque。

默认opaquetransparent
prompt_extend可选

自动扩展提示词。使用遮罩时忽略此参数。

默认true
enable_safety_checker可选

启用内容安全检查。

默认true
seed可选

可选整数或十进制整数字符串。超出 JavaScript 安全整数范围时请使用字符串;留空使用随机种子。

使用教程

  1. 上传 1–10 张参考图片通过界面上传或在 image_urls 数组中按顺序填入 1 至 10 个公网可访问的图片 URL,各素材按提示词中提及的顺序依次排列。

  2. 编写编辑指令与配置可选遮罩在 prompt 中清晰表述修改意图;若需局部精准修改,可上传一张与参考图比例一致的 Mask Url 黑白遮罩图片(白色重绘,黑色锁定)。

  3. 设置输出画幅与分辨率画幅比例默认设为 auto 自动跟随参考图比例,也可主动指定 1:1、16:9 等特定画幅,并选择 1K 或 2K 输出分辨率与所需格式。

  4. 提交异步编辑任务并获取结果发送 API 请求获取 task_id,任务后台处理完成后即可通过状态查询接口读取编辑完成的高清图像成品链接。

价格

每次输出一张图片,按 resolution 计费。参考图和遮罩不另收费。1 credit = $0.005。

用量费率详情
1K6 credits / 张$0.030 / 张
2K10 credits / 张$0.050 / 张

最佳应用场景

  • 电商虚拟试穿与模特多物料换装同时传入模特照片与多件服装鞋包参考图,将指定服饰自然贴合至模特身形,生成光影自然、布料褶皱真实的商用上身展示图。

  • 商品商业摄影智能换背景与场景迁移在严格保留商品原始外观、包装文字与材质细节的前提下,将简易白底静物照快速迁移至沙滩、现代极简家居或户外自然光影场景。

  • 精准局部瑕疵修复与细节修改通过黑白遮罩指定需要更改的手部姿势、面部表情、服饰印花或背景杂物,在无损保留画面其他区域的同时完成定向重绘。

  • 照片主体提取与透明免抠图层制作输入普通摄影照片并选择 transparent 透明背景模式,一键提取人物、宠物或独立商品的透明背景 RGBA 图层,用于海报排版合成。

专家技巧

  • 明确指定多图分工角色:当上传多张参考图时,在提示词中建议明确标示各图主体(例如“图1中人物的姿态,结合图2中夹克的款式与材质”),有助于引导模型更精准地分配图像特征。
  • 确保遮罩规范与前置条件:使用 mask_url 进行局部编辑时,必须恰好提供 1 张参考图,且 background 必须配置为 opaque;遮罩图片尺寸与比例应与参考图保持一致,白色代表重绘修改,黑色代表严格锁定保留。
  • 推荐优先保留 auto 画幅比例:Edit 端点默认 size 为 auto,能够无缝沿用首张参考图的原生宽高比,防止输出图片发生非预期的画面拉伸或边缘裁剪。
  • 使用遮罩时的参数联动特征:当传入 mask_url 时,后端接口会自动忽略 size 和 prompt_extend 参数,专注按照遮罩边界与原图结构执行精准重绘。

注意事项

  • image_urls 为必填参数,支持传入 1–10 个有序图片 URL,单张图片支持 JPEG、PNG、WebP 格式,最大不超过 30 MB 与 2500 万像素(25 MP)。
  • mask_url 仅在恰好传入一张参考图且 background 为 opaque 时有效,使用遮罩时 size 与 prompt_extend 将被自动忽略。
  • 端点按输出分辨率统一计费,1K 为 6 积分($0.030),2K 为 10 积分($0.050),参考图数量和遮罩使用不加收任何额外点数。
  • 模型基于 Qwen Research License 开源,授权条款仅面向科研评估;商业部署与商用销售请遵循官方许可协议及商用授权规范。

Qwen Image 2.1 Edit API 常见问题

Qwen Image 2.1 Edit API 是什么?

Qwen Image 2.1 Edit 是阿里巴巴通义团队研发的统一图像编辑模型。它根据 1–10 张参考图片与自然语言指令生成高保真编辑图像,支持多图特征融合、遮罩局部重绘、主体免抠提取与原生画幅自适应。基于 7B 参数 Single-Stream DiT 架构与 Qwen3-VL 编码器,它在精确保留人物五官身份、商品材质与非遮罩区原始像素的同时,实现自然的背景置换与局部重绘。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Qwen Image 2.1 Edit 最多支持上传多少张参考图片?

模型支持在 image_urls 数组中传入 1 至 10 张有序图片,能够胜任复杂的跨图主体合成与多元素迁移任务。得益于高效的 Prefix KV 缓存机制,多张参考图的视觉特征在第一个采样步中完成计算并全局复用,即便输入多达 10 张高分辨率大图也能维持极高的推理效率与稳定的显存占用。

Qwen Image 2.1 Edit 如何使用遮罩进行局部重绘?

局部编辑需配合 mask_url 参数传入一张黑白蒙版图片。使用遮罩时必须满足两项前置条件:仅提供 1 张参考图,且 background 配置为 opaque。在遮罩中,白色区域会被模型识别为目标重绘区域,黑色区域则会被严格锁定并无损保留原始像素。此外,一旦提供遮罩,系统将自动忽略 size 与 prompt_extend 参数,确保输出画面与原图保持完全一致的几何尺寸与细节精度。

Qwen Image 2.1 Edit 如何在编辑中保持人物面容或商品细节一致?

模型通过 Qwen3-VL 实现了文本与图像在语义空间的统一对齐,具备出色的人脸身份与商品形态记忆能力。在进行背景更换、光影重构或服饰替换时,模型能深度锁定主体的五官几何结构、发丝流向、品牌 Logo 与特定纹理。编写提示词时,建议采用“保持主体人物面容不变,仅更换背景为……”等针对性指令,以达到最佳的一致性保持效果。

Qwen Image 2.1 Edit 是否支持从普通照片中提取免抠透明主体?

支持。端点内置了强大的 64 通道 RGBA 自编码能力,可将常规 RGB 照片中的核心主体直接提取为带透明通道的独立图层。调用时将 background 参数设为 transparent 并选用 png 或 webp 格式,配合类似“提取画面中的核心主体,背景设为纯透明”的提示词指令,即可直接生成边缘干净平滑的透明素材,无需借助额外的抠图工具。

Qwen Image 2.1 Edit 上传多张参考图会产生额外的调用费用吗?

不会。Qwen Image 2.1 Edit 的计费仅与请求中的 resolution 分辨率相关:1K 档位每次生成固定消耗 6 积分($0.030),2K 档位消耗 10 积分($0.050),每积分价值 $0.005。无论在请求中输入 1 张还是 10 张参考图片,或者搭配使用局部重绘遮罩,均不收取任何输入素材或计算附加费。

Qwen Image 2.1 Edit 的输出画幅比例可以自动跟随原图吗?

可以。Edit 端点的 size 参数默认预设为 auto。在 auto 模式下,模型会自动读取并继承输入的第一张参考图的原始画幅比例,避免因比例不匹配而导致画面主体被裁剪或拉伸变形。如果用户希望将原图拓展或重构为特定画幅,也可以主动选择 1:1、16:9 或 9:16 等其他预设比例。