Qwen 图像生成与编辑支持基础和专业版本，多语言排版，多图像参考，以及可控制的 1K 或 2K 输出。
Alibaba Cloud图像生成发布日期 2026年7月21日Singapore专有端点新Qwen 图像生成与编辑支持基础和专业版本，多语言排版，多图像参考，以及可控制的 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 | - | - | 一到三个引用图像，作为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分辨率下，自动使用该层的平方大小。分辨率设置为自动时，模型选择完整的输出尺寸。 |
| resolution | enum | 2K | auto, 1K, 2K | 输出像素层。默认为2K，即最大支持层级。1K层保持在或低于2.25百万像素，而2K则高于2.25百万像素。自动允许模型选择何时将宽高比设置为自动;选择宽高比后，自动使用1K预设。 |
| size | string | - | - | 输出的精确大小为宽度×高度，例如2048×1536。这会覆盖aspect_ratio和分辨率。 |
| use_custom_size | boolean | false | - | 用custom_width和custom_height代替长弦比和分辨率预设。 |
| 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 | Direct用于生成和编辑。Agent则进行更深层的提示细化，仅对text-to-image请求开放。 |
Qwen Image 3.0 将 Base 和 Pro 图像生成与编辑合并为一个模型。默认选择 Pro 模式，输出从 2K 开始，宽高比从自动开始。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。- 提示支持最多4500个令牌。计费 - Base在1K和2K各使用一个输出速率。- Pro输出最高22.5百万像素使用1K速率。较大的Pro输出使用2K速率。- 每张参考图像都将上述输入图像速率相加。性能 - 1K世代优化以实现交互迭代。复杂的2K编辑可能需要几分钟。内容安全 生成的图片通过了自动内容安全检查。标记为露骨的图像不会返回。由于图像是在检查运行前生成的，标记生成仍会计费。
在 EmpirioLabs，Qwen Image 3.0 按量计费：基极输出（1K 或 2K） $0.030 每张图片; Pro 输出最高可达 2.25MP（1K） $0.040 每张图片; 专业输出超过2.25MP（2K） $0.075 每张图片; 输入图像（1K 或 2K） $0.003 每个输入图像。本页的实时价格表始终与 API 的实际计费一致。
Qwen Image 3.0 通过 api.empiriolabs.ai 上的 POST /v1/images/generations 提供，使用标准的 Bearer 令牌认证。
可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 Qwen Image 3.0，你可以在写代码之前先测试提示词。
创建 EmpirioLabs 账户，然后在控制台的 API Keys生成密钥。计费使用按量付费的额度，只为实际发出的请求付费。
