qwen-image-3 模型生成或编辑单张图片。仅给出提示词即为文生图,附带一到三个参考图 URL 即为图片编辑。GoEnhance 提供的是独立的 API 接入服务,并非阿里巴巴官方 API,也不是阿里巴巴的关联公司。Qwen-Image 3.0 API
通过 GoEnhance 使用
创建 API Key
把生成与编辑整合进同一套流程
一个端点,两种模式
向
/api/v1/images/generations 发送 POST 请求,并设置 model: qwen-image-3。仅传提示词即为文生图;传入一到三个可访问的参考图 URL 即为编辑。每次请求返回一张图片。
天然异步的结果返回
提交成功后会返回
img_uuid。请将其持久化保存,然后轮询 GET /api/v1/jobs/detail,或提供一个公网可访问的 HTTPS 回调地址,以接收 processing、success 和 failed 状态变更。
提交生成或编辑任务前,先核对文档中列出的字段。
Qwen-Image 3.0 API 参数
模型 ID
将
model 设为固定值 qwen-image-3。提示词
填写 1–2000 个字符,描述想要的画面或编辑效果。
宽高比
使用
auto,或从 1:1 到 1:8、8:1 之间选择文档中列出的比例。输出档位
选择
1K 或 2K;文档中的默认值为 2K。参考图
可选传入一到三个图片 URL,每张小于 10 MB,用于编辑。
提示词控制项
可选设置负向提示词、随机种子,以及 direct 或 agent 提示词扩写模式。
计费由输出费用加上参考图附加费构成。
Qwen-Image 3.0 API 价格
出图价格
每张 1K 或 2K 输出消耗 1.75 点数,相当于每张生成图片 $0.035。
参考图附加费
每张参考图额外消耗 0.19 点数,相当于每张参考图 $0.0039。
任务计费
带两张参考图的请求消耗 2.13 点数:1.75 + (2 × 0.19)。
接入 Qwen-Image 3.0 API
1
构造请求
在 Authorization 请求头中传入 API 凭证,然后 POST 一个带有
model 和 prompt 的 JSON 请求体。只在需要时才加上比例、图片尺寸或参考图 URL。 2
保存任务 ID
确认返回
code: 0,并保存返回的 img_uuid。点数不足和鉴权失败的响应要按失败处理,不能当作出图结果。 3
确认任务完成
轮询任务详情端点,或使用公网 HTTPS 回调。只有任务进入 success 之后才能采用产物;failed 状态需要显式处理。
无需自建模型推理服务,就能把图片生成和可控编辑接入生产流程。
开发者应用场景
产品视觉
用结构化提示词生成可直接投放的产品概念图。
创意变体
为广告、社媒帖子和落地页生成新的视觉方向。
参考图引导编辑
在保留提示词意图的前提下,改造一到三张给定的参考图。
本地化投放
依据本地化创意简报,产出针对特定市场的视觉概念。
素材流水线
在自动化内容流程中排队执行异步生成任务。
设计原型
在最终制作之前,先探索构图、材质与配色思路。
关于价格、输入和接入的常见问题解答。
Qwen-Image 3.0 API 常见问题
Qwen-Image 3.0 API 的端点是什么?
向 https://api.goenhance.ai/api/v1/images/generations 发送 POST 请求,并设置 model: qwen-image-3。
Qwen-Image 3.0 API 怎么收费?
文档中的出图价格为 1.75 点数,即 $0.035,1K 与 2K 同价。每张参考图额外消耗 0.19 点数,即 $0.0039。
这个 API 能编辑已有图片吗?
可以。传入 image_list,包含一到三个可访问的图片 URL,每张小于 10 MB。做纯文生图时省略该字段即可。
支持哪些宽高比?
该 API 支持 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。其中 1:8 和 8:1 的输出仅限 1K 档位。
回调是怎么工作的?
提供一个公网可访问的 HTTPS 回调地址。GoEnhance 会按任务详情接口的响应结构推送 processing、success 和 failed 状态变更。回调返回非 200 时最多重试三次,每次超时时间为三秒。
这是阿里巴巴官方 API 吗?
不是。Qwen 与阿里巴巴相关,而本端点由 GoEnhance 独立提供,并不意味着与阿里巴巴存在合作关系或得到其背书。如需阿里巴巴自营的服务,请查阅阿里云官方文档。
