Qwen Image 3.0 API

Qwen 图像生成与编辑支持基础和专业版本,多语言排版,多图像参考,以及可控制的 1K 或 2K 输出。

Alibaba Cloud 图像生成 发布日期 2026年7月21日 Singapore 专有端点

关于 Qwen Image 3.0

Qwen 图像生成与编辑支持基础和专业版本,多语言排版,多图像参考,以及可控制的 1K 或 2K 输出。

也称为 Qwen Image, Alibaba Cloud Qwen Image 3.0

image generation image editing multi image text rendering multilingual text dense layouts photorealism

Qwen Image 3.0 规格

模型 ID
qwen-image-3-0
开发方
Alibaba Cloud
类别
图像生成
发布日期
2026年7月21日
输入
文本图像
输出
图像
区域
Singapore
端点
POST/v1/images/generations
备用模型 ID
qwen-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

Qwen Image 3.0 API 价格

来自 EmpirioLabs 目录的实时按量计费价格。也可以选择包含每周用量额度的套餐。

类型
规格
价格
基极输出(1K 或 2K)
每张图片
$0.030
Pro 输出最高可达 2.25MP(1K)
每张图片
$0.040
专业输出超过2.25MP(2K)
每张图片
$0.075
输入图像(1K 或 2K)
每个输入图像
$0.003
在完整价格页比较

如何调用 Qwen Image 3.0 API

Qwen Image 3.0 通过 POST /v1/images/generations 运行。请求会立即返回 job_id;轮询 GET /v1/jobs/{job_id} 直到任务完成,再从结果中读取输出 URL。 也可以加上 "sync": true 跳过轮询:请求保持打开并直接返回 OpenAI 风格的完整图像响应,OpenAI SDK 可以原样使用。 在EmpirioLabs 控制台获取 API 密钥。

cURL:提交任务
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:轮询结果
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
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)
Qwen Image 3.0 API 完整参考

Qwen Image 3.0 API 参数

EmpirioLabs 上 Qwen Image 3.0 API 支持的请求参数。省略字段时使用默认值。

参数类型默认值范围 / 值描述
promptstring--描述要创建的图像。附加输入图像后,这就成为编辑指令。仅图像编辑使用中性保存提示。
model_variantenumqwen-image-3.0-proqwen-image-3.0-pro, qwen-image-3.0选择 Pro 以获得更强的写实感、密集的布局、精致的多语言排版和复杂的编辑,或选择 Base 以降低成本生成。当未设置时,模型 ID“qwen-image-3.0”、“alibaba/qwen-image-3.0”和“alibaba/qwen-image-3-0”选择 Base,而该模型的其他 id 则选择 Pro。
imagearray--一到三个引用图像,作为URL、数据URI或上传的图像对象。
imagesarray--多个上传图片参考的复数别名。
aspect_ratioenumautoauto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5可选输出宽高比。自动为默认。在固定的1K或2K分辨率下,自动使用该层的平方大小。分辨率设置为自动时,模型选择完整的输出尺寸。
resolutionenum2Kauto, 1K, 2K输出像素层。默认为2K,即最大支持层级。1K层保持在或低于2.25百万像素,而2K则高于2.25百万像素。自动允许模型选择何时将宽高比设置为自动;选择宽高比后,自动使用1K预设。
sizestring--输出的精确大小为宽度×高度,例如2048×1536。这会覆盖aspect_ratio和分辨率。
use_custom_sizebooleanfalse-用custom_width和custom_height代替长弦比和分辨率预设。
custom_widthnumber-256 到 2048自定义输出宽度(像素单位)。总面积必须在512x512到2048x2048之间,宽高比为1:8到8:1。
custom_heightnumber-256 到 2048自定义输出高度(像素单位)。总面积必须在512x512到2048x2048之间,宽高比为1:8到8:1。
num_imagesnumber11 到 6输出图像数量。每个输出单独计费。
negative_promptstring--描述输出中应避免的视觉元素或特质。
prompt_extendbooleantrue-自动展开提示,以增强构图和细节。
prompt_extend_modeenumdirectdirect, agentDirect用于生成和编辑。Agent则进行更深层的提示细化,仅对text-to-image请求开放。
文档中还有 3 个参数

须知

Qwen Image 3.0 将基础图像和 Pro 图像生成及编辑集成于一个模型中。默认选择 Pro 模式,输出从 2K 开始,宽高比从自动模式开始。基础模式提供了成本更低、快速迭代的选项。

变体

  • 选择qwen-image-3.0-pro,因为它具有逼真的写实感、密集的版面布局、精致的多语言排版和复杂的多图像编辑。
  • 选择qwen-image-3.0,以降低成本生成和常规编辑。
  • 用model_variant选择。没有它,模型ID(qwen-image-3.0)、alibaba/qwen-image-3.0和alibaba/qwen-image-3-0运行Base,而该型号的其他ID运行Pro。

模式

  • 从提示词转图片。
  • 图像编辑和参考引导生成,从一到三张图像。
  • 直接提示扩展用于生成和编辑。代理提示扩展仅对text-to-image请求提供更深入的细化。

输出与输入限制

  • 每个请求输出一到六张图像。
  • 1K、2K、自动、长宽比预设,或者精确自定义尺寸。
  • 预设和自定义尺寸保持在512x512到2048x2048像素之间,每边最大可达2048像素,宽高比为1:8至8:1。自动尺寸调整可在1K或2K输出层级内自行选择尺寸。
  • 输入图片可以是JPG、JPEG、PNG、BMP、TIFF、WEBP或GIF,每个最多10MB。
  • 提示最多支持4500个代币。

账单

  • 基极在1K和2K上使用一种输出速率。
  • Pro 输出高达 2.25 百万像素使用 1K 速率。更大的 Pro 输出使用 2K 速率。
  • 每张参考图像都将上述输入图像率相加。

性能

  • 1K世代优化为交互迭代。复杂的2K编辑可能需要几分钟。

内容安全

生成的图像通过了自动内容安全检查。标记为显式的图像不会返回。由于该图像是在检查运行前生成的,标记生成仍会计费。

Qwen Image 3.0 生成模板

以 Qwen Image 3.0 为推荐模型的特效。打开即可查看预览和运行方法。 全部生成模板

Qwen Image 3.0 相关博客文章

涵盖这个模型的公告、提示词测试和对比文章。

Qwen Image 3.0 API:常见问题

Qwen Image 3.0 API 收费多少?

在 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 支持哪些输入和输出?

Qwen Image 3.0 接受 文本, 图像 作为输入,并返回 图像。

Qwen Image 3.0 支持哪些分辨率?

Qwen Image 3.0 支持 auto, 1K, 2K。默认值为 2K,各分辨率的限制见参数参考。

Qwen Image 3.0 使用哪个端点?

Qwen Image 3.0 通过 api.empiriolabs.ai 上的 POST /v1/images/generations 提供,使用标准的 Bearer 令牌认证。

Qwen Image 3.0 的模型 ID 是什么?

在请求中将 qwen-image-3-0 作为 model 发送。备用 ID qwen-image-3.0, qwen-image-3-0-pro, qwen-image-3.0-pro, alibaba/qwen-image-3-0, alibaba/qwen-image-3.0, alibaba/qwen-image-3-0-pro, alibaba/qwen-image-3.0-pro 同样可用。

Qwen Image 3.0 是什么时候发布的?

Alibaba Cloud 于 2026年7月21日 发布了 Qwen Image 3.0。

Qwen Image 3.0 从哪里提供服务?

EmpirioLabs 上的 Qwen Image 3.0 从 Singapore 提供服务。

集成之前可以在浏览器里试用 Qwen Image 3.0 吗?

可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 Qwen Image 3.0,你可以在写代码之前先测试提示词。

如何获取 Qwen Image 3.0 API 密钥?

创建 EmpirioLabs 账户,然后在控制台的 API Keys生成密钥。计费使用按量付费的额度,只为实际发出的请求付费。也可以选择包含每周用量额度的套餐。

将 Qwen Image 3.0 与其他模型比较

全部模型比较

准备好使用更好的终端了吗?

查看我们的定价,或者如果你想将自己的模型部署到我们的堆栈中,请联系我们。