Qwen Image 3.0 Pro 图像编辑 API

alibaba/qwen-image-3.0-pro/edit
1–3 images · Standard/Pro · 1K/2K

Qwen Image 3.0 Pro Image Edit API 接受 1–5,000 个字符的编辑提示词和一至三个有序源图 URL。异步图片任务可选择八种画面比例、1K/2K 分辨率,以及 PNG 或 JPEG 输出。

获取 API 密钥

输入

557/5000
1/3
Reference image 1: Reference 1

输出

已就绪
Qwen Image 3.0 generated result 1
6.4 + (1 × 0.5) = 6.9 credits · $0.035

继续使用

示例

pro-edit-01-output.jpg

Use image 1 as the sole source. Preserve the exact glacier silhouette, accumulation basin, compressed blue-ice layers, flow direction, calving face, crystal inset, arrows, framing, and geological relationships. Refine only the scientific visual clarity: increase the distinction between snow, firn, and blue ice; reveal finer crystal layers and moraine textures; make arrow weights more consistent; and add subtle depth lighting inside the cutaway without moving any element. Do not add writing, labels, logos, products, promotional elements, or watermarks.

pro-edit-02-output.jpg

Image 1 is authoritative for the complete observatory architecture, cutaway geometry, five numbered bilingual zone labels, circulation, cables, north arrow, scale, and camera view. Image 2 contributes only its quiet archival paper, charcoal annotation, and oxidized-green accent language. Re-render image 1 as a refined architectural archive plate using those surface qualities while preserving every structural relationship and every word from image 1. Do not import the bronze vessel or any label from image 2. Keep concrete, timber, metal, and rock materially distinct. No firm branding, property promotion, products, extra text, or watermark.

pro-edit-03-output.jpg

Edit image 1 while locking image 1 as the sole composition and scene. The final result must remain one continuous full-frame vertical underwater view with the same surface buoy, single descending fiber cable, seafloor observatory station, equipment positions, organisms, seabed, and cyan-to-navy depth lighting from image 1. Use image 2 only as a microscopic reference for clearer translucent material layering inside small pressure-resistant components; do not copy its glacier, arrows, inset, mountains, white background, or composition. Use image 3 only as a microscopic reference for realistic metal, concrete-like pressure housings, and precise color-coded cable routing; do not copy its building, dome, rooms, stairs, rock mountain, labels, or composition. Improve fine structure and cable legibility without creating comparisons or separate regions. No split screen, panels, columns, borders, arrows, numbers, writing, labels, logos, brands, promotion, or watermark.

Qwen Image 3.0 Pro 图像编辑

Qwen Image 3.0 Pro Image Edit API 按分辨率收取基础费,每张源图另加 0.5 积分。1K 基础费率为 6.4 积分,2K 为 12 积分;image_urls 接受一至三个有序公开 HTTP(S) URL。

为什么选择 Qwen Image 3.0 Pro Image Edit API?

  • 写明需要保持辨识度的细节。在编辑提示词中列出需要延续的产品、身份、文字、几何或材质。

  • 指导多个源图角色。分别使用图片定义主资产、视觉语言与目标环境。

  • 处理大幅修改。改变构图、场景、光线或风格,同时延续源图特征。

  • 在两种分辨率费率之间选择。1K 基础费率为 6.4 积分,2K 为 12 积分,每张源图另加 0.5 积分。

参数

参数要求说明
prompt必填

去除首尾空白后包含 1–5,000 个字符的编辑指令。

image_urls必填

一至三个公开 HTTP(S) 图片 URL 的有序数组,每个位置对应提示词中的图片角色。

size可选

输出画面比例。

默认1:13:22:34:33:416:99:1621:9
resolution可选

输出分辨率。

默认1K2K
output_format可选

输出图片编码。

默认pngjpeg
prompt_extend可选

控制自动扩展提示词的布尔值。

negative_prompt可选

描述不希望出现的内容,最多 5,000 个字符。

seed可选

0 至 2,147,483,647 的整数,包含边界值。

enable_safety_checker可选

控制内容安全检查的布尔值。

使用方法

  1. 分配每张源图。将主资产放在第一位,并为后续每张图片指定一个明确用途。

  2. 写出保留规则。列出需要保持的身份、形状、文字、颜色、材质或版式关系。

  3. 指导画面转换。在固定要求之后描述新的构图、环境、光线与风格。

  4. 检查返回图片。核对目标变化,并将提示词中列出的产品、身份、文字和材质细节与源图对照。

价格

Pro 图像编辑按分辨率收取基础费,每张输入图另加 0.5 积分,每积分按 $0.005 换算。

用量费率详情
1K 编辑,一至三张图6.9–7.9 积分6.4 基础积分,每张源图另加 0.5 积分。
2K 编辑,一至三张图12.5–13.5 积分12 基础积分,每张源图另加 0.5 积分。

适用场景

  • 产品环境修改使用产品源图请求新的活动环境,并写明需要延续的包装几何、标签和材质。

  • 人像修改使用人像源图请求服装、光线或环境变化,并写明需要延续的脸部细节。

  • 多源图艺术指导分别用图片定义主体、视觉系统和目标环境。

  • 精细版式修改针对商业裁切、图中文字和后续制作细化构图。

专业技巧

  • 明确引用图片 1、图片 2 和图片 3,让每张源图的角色没有歧义。
  • 把不可改变的保留规则放在视觉修改之前。
  • 只使用在最终方向中承担不同任务的源图。
  • 选择 2K 时,具体说明需要重点检查的材质、边缘和文字。
  • 所有上传都获得公开 HTTP(S) URL 后再提交任务。

注意事项

  • 源图顺序保持不变,并应与提示词描述的角色对应。
  • 体验区接受 JPEG、PNG 或 WebP,单个文件最大 30 MB。
  • 体验区会开启提示词扩展和安全检查,并显式发送对应值。
  • finished 应包含有效图片文件,failed 同样会结束任务。

Qwen Image 3.0 Pro 图像编辑常见问题

什么是 Qwen Image 3.0 Pro 图像编辑 API?

Qwen Image 3.0 Pro Image Edit API 使用 qwen-image-3.0-pro/edit 模型 ID 接受提示词和一至三个有序公开 HTTP(S) 图片 URL,并返回 1K 或 2K 的异步 PNG/JPEG 图片任务。

如何调用 Pro 图像编辑?

先将源图上传为公开 HTTP(S) URL,携带 Bearer 密钥提交 Pro 模型与 input 对象,再查询任务 ID 或使用回调。

Pro 图像编辑如何计费?

1K 基础为 6.4 积分,2K 基础为 12 积分,每张源图另加 0.5 积分,具体范围见价格表。

哪些输入决定 Pro 编辑?

提示词和一至三张有序图片 URL 为必填,其他输出、提示词、seed 与安全控制见上方参数表。

编辑图片如何返回?

finished 后读取全部有效的 data.files[].file_url;failed 后停止轮询并显示 error_message。

应该使用 Standard 编辑还是 Pro 编辑?

Standard Edit 在 1K/2K 下基础费率均为 4.8 积分;Pro Edit 的 1K 基础费率为 6.4 积分,2K 为 12 积分。两者每张源图均另加 0.5 积分,并接受一至三个有序图片 URL。