Quen图像生成和编辑与Base和Pro变体,多语种打字法,多图像参考,以及可控1K或2K输出.
Alibaba Cloud图像生成发布日期 2026年7月21日Singapore专有端点新Quen图像生成和编辑与Base和Pro变体,多语种打字法,多图像参考,以及可控1K或2K输出.
也称为 Qwen Image, Alibaba Cloud Qwen Image 3.0
qwen-image-3-0/v1/images/generationsqwen-image-3.0qwen-image-3-0-proqwen-image-3.0-proalibaba/qwen-image-3-0alibaba/qwen-image-3.0alibaba/qwen-image-3-0-proalibaba/qwen-image-3.0-pro来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费，没有月度最低消费。
Qwen Image 3.0 通过 POST /v1/images/generations 运行。请求会立即返回 job_id；轮询 GET /v1/jobs/{job_id} 直到任务完成，再从结果中读取输出 URL。 也可以加上 "sync": true 跳过轮询：请求保持打开并直接返回 OpenAI 风格的完整图像响应，OpenAI SDK 可以原样使用。 在EmpirioLabs 控制台获取 API 密钥。
curl https://api.empiriolabs.ai/v1/images/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-3-0",
"prompt": "Describe what you want Qwen Image 3.0 to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "qwen-image-3-0",
"prompt": "Describe what you want Qwen Image 3.0 to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs 上 Qwen Image 3.0 API 支持的请求参数。省略字段时使用默认值。
| 参数 | 类型 | 默认值 | 范围 / 值 | 描述 |
|---|---|---|---|---|
| prompt | string | - | - | 描述要创建的图像 。 随着输入图像的附着,这成为编辑指令. 只使用图像编辑使用中性保存提示 。 |
| model_variant | enum | qwen-image-3.0-pro | qwen-image-3.0-pro, qwen-image-3.0 | 选择 Pro 以更强的光现实主义,密集的布局,精细的多语种印刷,和复杂的编辑,或 Base 以低成本生成. |
| image | array | - | - | 1到3个参考图像作为URL,数据URI,或上传的图像对象. |
| images | array | - | - | 多个上传图像引用的多元别名 。 |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5 | 可选输出宽比 。 自动是默认值 。 用固定的1K或2K分辨率,Auto使用该级的平方大小. 随着分辨率设定为Auto,模型选择完整的输出大小. |
| resolution | enum | 2K | auto, 1K, 2K | 输出像素级. 默认为 2K, 最大支持的级别 。 1K级停留在2.25兆像素或以下,而2K级则高于2.25兆像素. 自动让模型选择当Aspect 比率是Auto时;如果有选定的宽比,Auto使用1K预设. |
| size | string | - | - | 精确输出大小为 WIDTH*HEIGHT,例如2048*1536. 这超越了维度和分辨率。 |
| use_custom_size | boolean | false | - | 使用自定义 width 和自定义 hight 来代替侧面- ratio 和分辨率预设 。 |
| custom_width | number | - | 256 到 2048 | 自定义像素输出宽度 。 总面积必须在512x512至2048x2048之间,宽比从1:8到8:1. |
| custom_height | number | - | 256 到 2048 | 自定义像素输出高度 。 总面积必须在512x512至2048x2048之间,宽比从1:8到8:1. |
| num_images | number | 1 | 1 到 6 | 输出图像的数量 。 每个产出单独计费。 |
| negative_prompt | string | - | - | 描述可见元素或品质,以便在输出中避免. |
| prompt_extend | boolean | true | - | 自动扩展提示以获取更强的构成和细节 。 |
| prompt_extend_mode | enum | direct | direct, agent | 直接作品用于生成和编辑. 代理进行更深的即时改进,只能用于 text-to-image 请求. |
Quen Image 3.0将Base和Pro图像生成和编辑结合为一个模型. Pro是默认选择的,输出起始于2K,宽比开始于Auto. Base为快速迭代提供了成本较低的选项. 变体 - 选择 qwen-image-3.0-pro 用于摄影现实主义,密集布局,精细的多语种排版,以及复杂的多图像编辑. - 选择 qwen-image-3.0,用于低成本生成和常规编辑. 模式 - 文本到图像从一个提示。 - 图像编辑和参考指导生成从一到三幅图像。 - 用于生成和编辑的直接即时扩展工程。 代理即时扩展仅为 text-to-image 请求提供更深的改进. 产出和输入限制 - 每个请求一至六张输出图像。 - 1K,2K,自动的,宽角预设,或精确的自定义大小. - 预设大小和自定义大小在512x512至2048x2048像素之间,每个选定的边最大2048像素,宽比从1:8到8:1. 自动缩放可以在1K或2K输出级内选择自己的维度. - 输入图像可以是JPG,JPEG,PNG,BMP,TIFF,WEBP,或GIF,每个最多10 MB. - 提示支持最多4 500个代币。 Billing - Base使用1K和2K的输出率。 - 最多2.25兆像素的输出采用1K率。 Pro输出量较大,使用2K率. - 每个参考图像都增加了上述输入图像率。 绩效 - 1K代最优化用于交互迭代. 复杂2K编辑需要几分钟. 连带安全 生成的图像通过自动内容安全检查 。 未返回标记为清晰的图像 。 因为图像是在检查运行之前生成的,所以标注的一代仍然被记帐.
在 EmpirioLabs，Qwen Image 3.0 按量计费：基输出(1K或2K) $0.030 每个图像; 最多2.25MP(1K)的Pro输出 $0.040 每个图像; 2.25MP以上的Pro产出(2K) $0.075 每个图像。本页的实时价格表始终与 API 的实际计费一致。
Qwen Image 3.0 通过 api.empiriolabs.ai 上的 POST /v1/images/generations 提供，使用标准的 Bearer 令牌认证。
可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 Qwen Image 3.0，你可以在写代码之前先测试提示词。
创建 EmpirioLabs 账户，然后在控制台的 API Keys生成密钥。计费使用按量付费的额度，只为实际发出的请求付费。
