
支持Pro和Turbo版本的图像生成和编辑,最多支持十张参考图片,透明PNG输出,以及最高可自定义尺寸2560x2560。
支持Pro和Turbo版本的图像生成和编辑,最多支持十张参考图片,透明PNG输出,以及最高可自定义尺寸2560x2560。
也称为 Qwen Image, Alibaba Cloud Qwen Image 2.1
qwen-image-2-1/v1/images/generationsqwen-image-2.1qwen-image-2.1-proqwen-image-2.1-turboalibaba/qwen-image-2-1alibaba/qwen-image-2.1来自 EmpirioLabs 目录的实时按量计费价格。只为实际用量付费,没有月度最低消费。
Qwen Image 2.1 通过 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-2-1",
"prompt": "Describe what you want Qwen Image 2.1 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-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)EmpirioLabs 上 Qwen Image 2.1 API 支持的请求参数。省略字段时使用默认值。
| 参数 | 类型 | 默认值 | 范围 / 值 | 描述 |
|---|---|---|---|---|
| prompt | string | - | - | 描述要创建的图像。附加输入图像后,这就成为编辑指令。仅图像编辑使用中性保存提示。 |
| model_variant | enum | qwen-image-2.1-pro | qwen-image-2.1-pro, qwen-image-2.1-turbo | 选择 Pro 以获得最高画质和复杂编辑,或选择 Turbo 以获得更快、更低成本的生成。当未设置时,model id “qwen-image-2.1-turbo” 会选择 Turbo,而该型号的其他 ID 则选择 Pro。 |
| image | array | - | - | 其中1到10张以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预设。 |
| size | string | - | - | 输出的精确大小为宽度×高度,例如2048×1536。这会覆盖aspect_ratio和分辨率。 |
| use_custom_size | boolean | false | - | 用custom_width和custom_height代替长弦比和分辨率预设。 |
| custom_width | number | - | 256 到 4096 | 自定义输出宽度(像素单位)。总面积必须在512x512到2560x2560之间,宽高比为1:8到8:1。 |
| custom_height | number | - | 256 到 4096 | 自定义输出高度(像素单位)。总面积必须在512x512到2560x2560之间,宽高比为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 2.1 将 Pro 和 Turbo 图像生成及编辑集成于一个模型中。默认选择 Pro 模式,输出从 2K 开始,宽高比从自动开始。Turbo 提供了更快、更低成本的选项。
生成的图像通过了自动内容安全检查。标记为显式的图像不会返回。由于该图像是在检查运行前生成的,标记生成仍会计费。
在 EmpirioLabs,Qwen Image 2.1 按量计费:优点 $0.040 每张图片; 涡轮 $0.016 每张图片。本页的实时价格表始终与 API 的实际计费一致。
Qwen Image 2.1 通过 api.empiriolabs.ai 上的 POST /v1/images/generations 提供,使用标准的 Bearer 令牌认证。
可以。EmpirioLabs Playground在浏览器中以与 API 相同的参数运行 Qwen Image 2.1,你可以在写代码之前先测试提示词。
创建 EmpirioLabs 账户,然后在控制台的 API Keys生成密钥。计费使用按量付费的额度,只为实际发出的请求付费。