Qwen-Image 3.0 API

通过 GoEnhance 使用 qwen-image-3 模型生成或编辑单张图片。仅给出提示词即为文生图,附带一到三个参考图 URL 即为图片编辑。GoEnhance 提供的是独立的 API 接入服务,并非阿里巴巴官方 API,也不是阿里巴巴的关联公司。
创建 API Key
代表 Qwen-Image 3.0 API 生成能力的抽象工作室场景

把生成与编辑整合进同一套流程

一个端点,两种模式

向 /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 状态需要显式处理。
创建 API Key
无需自建模型推理服务,就能把图片生成和可控编辑接入生产流程。

开发者应用场景

产品视觉

用结构化提示词生成可直接投放的产品概念图。

创意变体

为广告、社媒帖子和落地页生成新的视觉方向。

参考图引导编辑

在保留提示词意图的前提下,改造一到三张给定的参考图。

本地化投放

依据本地化创意简报,产出针对特定市场的视觉概念。

素材流水线

在自动化内容流程中排队执行异步生成任务。

设计原型

在最终制作之前,先探索构图、材质与配色思路。
关于价格、输入和接入的常见问题解答。

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 独立提供,并不意味着与阿里巴巴存在合作关系或得到其背书。如需阿里巴巴自营的服务,请查阅阿里云官方文档。

开始用 Qwen-Image 3.0 构建

Qwen-Image 3.0 API:价格与接入 | GoEnhance