img_uuid 后轮询或使用回调。GoEnhance 提供的是独立接入,并非阿里巴巴的官方 API。Qwen-Image 3.0 Pro API
通过 GoEnhance 调用 Qwen-Image 3.0 Pro,用同一个端点完成文生图与参考图引导的编辑。提交提示词,可选附上最多三个图片 URL,拿到
创建 API Key
生成与编辑共用一个端点
提交前先校验请求模式、比例、输出档位和可选控制项。
Qwen-Image 3.0 Pro API 参数
必填模型
把
model 设为 qwen-image-3-pro。提示词
必须传入 1 到 2000 个字符的文本提示词。
画面比例
可选
auto,或在从 1:1 到 8:1 的 13 个文档化比例中任选其一。输出档位
把
image_size 设为 1K 或 2K;默认是 2K。参考图
可选地在
image_list 里传入一到三个 URL 对象,每个都要小于 10MB。提示词控制项
还可以选填负面提示词、0 到 2147483647 之间的种子值,或
prompt_extend_mode。其中 agent 模式仅支持文生图。费用由输出档位加上每张参考图的附加费构成。
Qwen-Image 3.0 Pro API 价格
1K 输出
文档价格为每生成一张 1K 图片 2.43 tokens($0.049)。
2K 输出
文档价格为每生成一张 2K 图片 4.85 tokens($0.097)。使用
ratio: auto 的请求按这一档计费。参考图附加费
每张参考图额外增加 0.19 tokens($0.0039)。
1:8 和 8:1 这两个比例只能用 1K 档,也按 1K 档计费。三步接入 Qwen-Image 3.0 Pro
1
1. 构造并校验
先决定用文生图还是参考图编辑,写好提示词,校验比例和图片 URL,再加上鉴权请求头。
2
2. 提交并保存
带上
model: qwen-image-3-pro 发起 POST 请求,并保存返回的 img_uuid。 3
3. 处理终态
轮询
GET /api/v1/jobs/detail 或接收 HTTPS 回调事件,直到任务成功或失败,然后保存产物或处理错误。既支持全新图像生成,也支持可控的参考图工作流。
Qwen-Image 3.0 Pro API 应用场景
产品视觉
生成可直接用于营销活动的场景概念图,或把已确认的产品参考图编辑进新环境。
广告素材变体
为 banner、付费投放和节庆创意测试产出由提示词驱动的视觉方向。
设计原型
在正式投入制作之前,先把文字版美术方向变成图像概念。
参考图引导的风格改写
用最多三张有先后顺序的参考图,引导构图、主体细节或视觉处理方式。
本地化营销活动
在保持接口契约不变的前提下,生成面向不同地区的场景变体。
内容流水线
把异步生成接入你应用里的审核、复核、存储与发布系统。
解答价格、输入、异步交付以及阿里巴巴 API 搜索意图相关的问题。
Qwen-Image 3.0 Pro API 常见问题
Qwen-Image 3.0 Pro API 怎么收费?
GoEnhance 文档给出的价格是:1K 输出每张 2.43 tokens($0.049),2K 输出每张 4.85 tokens($0.097),每张参考图再加 0.19 tokens($0.0039)。
这是阿里巴巴的官方 API 吗?
不是。Qwen 与阿里巴巴相关,而本页描述的是 GoEnhance 提供的独立 API 接入,并不代表双方存在合作关系或获得对方背书。需要由阿里巴巴运营的 API 的开发者,请查阅阿里云的官方文档。
同一个端点既能生成也能编辑图像吗?
可以。不传 image_list 就是文生图;传入一到三个参考图 URL 就是编辑。该端点每次返回一张生成图。
支持哪些画面比例?
文档给出的取值是 auto、1:1、16:9、9:16、4:3、3:4、2:3、3:2、1:2、2:1、1:4、4:1、1:8 和 8:1。
提示词扩写是怎么工作的?
默认的 direct 模式直接使用原提示词。agent 会改写得更彻底,但只对不带 image_list 的文生图请求有效。
API 会立刻返回图片吗?
不会。提交成功后返回的是 img_uuid。请轮询任务详情端点,或通过回调事件获取终态结果。
回调地址不可用会怎样?
如果你的端点没有返回 HTTP 200,按 GoEnhance 文档最多重试三次回调,每次尝试超时三秒。轮询依然是可行的兜底方案。


