Qwen Image 2.1 API

支持Pro和Turbo版本的图像生成和编辑,最多支持十张参考图片,透明PNG输出,以及最高可自定义尺寸2560x2560。

Alibaba Cloud图像生成发布日期 2026年10月2日Singapore专有端点新

关于 Qwen Image 2.1

支持Pro和Turbo版本的图像生成和编辑,最多支持十张参考图片,透明PNG输出,以及最高可自定义尺寸2560x2560。

也称为 Qwen Image, Alibaba Cloud Qwen Image 2.1

image generationimage editingmulti imagemulti referencetransparent backgroundtext rendering

Qwen Image 2.1 规格

模型 ID
qwen-image-2-1
开发方
Alibaba Cloud
类别
图像生成
发布日期
2026年10月2日
输入
文本图像
输出
图像
区域
Singapore
端点
POST/v1/images/generations
备用模型 ID
qwen-image-2.1qwen-image-2.1-proqwen-image-2.1-turboalibaba/qwen-image-2-1alibaba/qwen-image-2.1

Qwen Image 2.1 API 价格

来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费,没有月度最低消费。

类型
规格
价格
优点
每张图片
$0.040
涡轮
每张图片
$0.016
在完整价格页比较

如何调用 Qwen Image 2.1 API

Qwen Image 2.1 通过 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-2-1",
    "prompt": "Describe what you want Qwen Image 2.1 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-2-1",
        "prompt": "Describe what you want Qwen Image 2.1 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 2.1 API 完整参考

Qwen Image 2.1 API 参数

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

参数类型默认值范围 / 值描述
promptstring--描述要创建的图像。附加输入图像后,这就成为编辑指令。仅图像编辑使用中性保存提示。
model_variantenumqwen-image-2.1-proqwen-image-2.1-pro, qwen-image-2.1-turbo选择 Pro 以获得最高画质和复杂编辑,或选择 Turbo 以获得更快、更低成本的生成。当未设置时,model id “qwen-image-2.1-turbo” 会选择 Turbo,而该型号的其他 ID 则选择 Pro。
imagearray--其中1到10张以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预设。
sizestring--输出的精确大小为宽度×高度,例如2048×1536。这会覆盖aspect_ratio和分辨率。
use_custom_sizebooleanfalse-用custom_width和custom_height代替长弦比和分辨率预设。
custom_widthnumber-256 到 4096自定义输出宽度(像素单位)。总面积必须在512x512到2560x2560之间,宽高比为1:8到8:1。
custom_heightnumber-256 到 4096自定义输出高度(像素单位)。总面积必须在512x512到2560x2560之间,宽高比为1:8到8:1。
num_imagesnumber11 到 6输出图像数量。每个输出单独计费。
negative_promptstring--描述输出中应避免的视觉元素或特质。
prompt_extendbooleantrue-自动展开提示,以增强构图和细节。要求透明背景时关闭提示。
prompt_extend_modeenumdirectdirect, agentDirect用于生成和编辑。Agent则进行更深层的提示细化,仅对text-to-image请求开放。
文档中还有 3 个参数

须知

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

变体

  • 选择qwen-image-2.1-pro以获得最高画质和复杂编辑。
  • 选择qwen-image-2.1-turbo以实现更快、更低成本的生成和常规编辑。
  • 用model_variant选。没有它,型号IDqwen-image-2.1-turbo运行Turbo,而该型号的其他ID运行Pro。

模式

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

透明图像

  • 输出图像为PNG文件。对于透明背景,将prompt_extend设为false,并以此形式描述图像:“这是一张带透明的RGBA图像。一个玻璃香水瓶。图像具有alpha通道,背景是透明的。”

输出极限

  • 每个请求输出一到六张图像。
  • 1K、2K、自动、长宽比预设,或者精确自定义尺寸。
  • 精确和自定义尺寸在总面积上保持在512x512到2560x2560像素之间,宽高比为1:8到8:1。

账单

  • 每个输出图像按其变体的费率计费。参考图像不计费。

内容安全

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

Qwen Image 2.1 API:常见问题

Qwen Image 2.1 API 收费多少?

在 EmpirioLabs,Qwen Image 2.1 按量计费:优点 $0.040 每张图片; 涡轮 $0.016 每张图片。本页的实时价格表始终与 API 的实际计费一致。

Qwen Image 2.1 使用哪个端点?

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

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

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

如何获取 Qwen Image 2.1 API 密钥?

创建 EmpirioLabs 账户,然后在控制台的 API Keys生成密钥。计费使用按量付费的额度,只为实际发出的请求付费。

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

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