Qwen Image 2.1 Pro

Qwen Image 2.1 Pro 是阿里通义千问团队全新推出的生修一体化旗舰图像大模型。模型基于优化的 70 亿参数单流 DiT 架构打造，将 2K 原生超清文生图、原生透明背景（RGBA）直接合成以及多模式精细图像编辑深度融合。模型支持最多 10 张参考图输入与圈选/涂抹局部蒙版编辑，能在微调中精准保持人像面部特征与商品主体的一致性，同时具备强悍的图像内文字排版与自然人像光影质感。非常适合电商商品抠图与主图排版、品牌营销海报设计、IP 角色多场景延展以及自动化高精视觉创作流水线。

Qwen Image 2.1 Pro

Qwen Image 2.1 Pro 是阿里巴巴旗舰级第二代视觉生成基础模型，具备行业领先的渲染精度、复杂场景合成能力和多语言文字渲染能力。模型基于统一的视觉语言框架，在单一架构中原生集成文生图、图生图和精细化视觉编辑功能。模型支持原生 2K 分辨率输出（总像素数介于 $512 \times 512$ 和 $2048 \times 2048$ 之间，宽高比范围为 1:8 至 8:1）、原生 RGBA 透明图像生成，以及最多 10 张参考图像的多图条件生成。

基础 URL

https://api.icreat.ai

身份验证

所有 API 请求都必须使用 API Key 进行身份验证。你可以在控制台获取 API Key。

export ICREAT_API_KEY="your-api-key-here"

HTTP 请求头

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

保护你的 API Key

切勿在客户端代码或公开代码仓库中暴露 API Key。请使用环境变量或后端代理。

代码示例

图像生成采用两步异步流程：先提交任务获取 task_id，再通过查询任务结果接口轮询。响应包含 status 和 result（处理中 result 为 []；当状态为 SUCCEEDED 时，result 包含生成资源，响应中同时返回 costUSD）。以下示例在两个步骤中使用相同的 task_id。

1. 提交任务

向提交接口发送生成请求。

POST/v1/task/submit/aliyun/qwen-image-2-1-pro

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/aliyun/qwen-image-2-1-pro \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "image": "https://example.com/example.png"
          },
          {
            "text": "将主角的服装替换为赛博朋克风格的发光夹克，并将背景调整为雨夜的霓虹街区"
          }
        ]
      }
    ]
  },
  "parameters": {
    "watermark": true,
    "size": "2048*2048"
  }
}'

2. 查询任务结果（轮询）

使用提交任务时返回的 task_id 轮询进度，直到任务进入终态。响应包含 status 和 result：处理中 result 为 []；当状态为 SUCCEEDED 时，result 包含生成资源，响应中同时返回 costUSD；FAILED 表示任务失败。

POST/v1/task/result

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task-xxx"}'

输入结构

提交任务 — 输入

提交请求体支持以下参数。

总计：2 必填：1 可选：1

inputobject必填

生成任务的输入数据。

parametersobject

生成参数。

查询任务结果 — 输入

总计：1 必填：1 可选：0

task_idstring必填

提交接口返回的任务 ID。

输出结构

提交任务 — 输出

总计：1

task_idstring

异步任务标识符。

查询任务结果 — 输出

总计：可变

statusstring

当前任务状态。成功前，result 通常为 []；当状态为 SUCCEEDED 时，result 包含生成资源，响应中同时返回 costUSD。

SUBMITTEDSUCCEEDEDFAILED

resultarray[object]

生成的资源。处理中或失败时为空数组；成功时为资源对象数组。

costUSDnumber

任务费用，单位为美元（每次成功生成收费 0.04 美元）。仅在 status 为 SUCCEEDED 时返回。

LLM 提示词

以下 Markdown 是一份适合 LLM 阅读的提示词，可粘贴到 AI 助手（如 Cursor、ChatGPT）中，帮助其理解该模型的 API、调用流程和关键参数。使用复制给 AI按钮，或直接复制下方代码块中的内容。

# aliyun/qwen-image-2-1-pro

> Qwen Image 2.1 Pro 是阿里巴巴旗舰级第二代视觉生成基础模型，支持原生 2K 分辨率输出、文生图、图像编辑和多参考图像合成。

## 概述

使用 iCreat 两步异步任务 API：先提交生成请求，再轮询查询任务结果接口；成功后从 `result` 中读取资源，响应中同时返回 `costUSD`。

## API 信息

- **基础 URL**：`https://api.icreat.ai`
- **提交接口（POST）**：`/v1/task/submit/aliyun/qwen-image-2-1-pro`
- **查询结果接口（POST）**：`/v1/task/result`
- **模型 ID**：`aliyun/qwen-image-2-1-pro`
- **身份验证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **提交**：向提交路径发送 POST 请求，请求体遵循输入说明；响应为 `{ "task_id": "..." }`
2. **查询结果**：向 `/v1/task/result` 发送 POST 请求，请求体为 `{ "task_id": "..." }`；响应包含 `status` 和 `result`（处理中为 `[]`）；当状态为 `SUCCEEDED` 时，`result` 包含资源，响应中同时返回 `costUSD`（0.04 美元）；读取 `type` 为 `Image` 的资源的 `url` 或 `download_url`

### 输入说明

- 顶层请求体：`input`（对象）与 `parameters`（对象）为同级字段
- `input.messages`（必填）
- `input.messages[].role`（必填）：消息角色（`user`）。
- `input.messages[].content`（必填）：内容对象数组。
- `input.messages[].content[].text`（可选）：文本提示词或编辑指令。
- `input.messages[].content[].image`（可选）：参考图像 URL（最多支持 10 张输入图像，宽度和高度范围为 1 至 8000 像素）。
- `parameters.size`（可选）：输出图像尺寸，总像素数介于 $512 \times 512$ 和 $2048 \times 2048$ 之间，宽高比范围为 1:8 至 8:1。例如 `"2048*2048"`、`"1024*1024"`、`"2688*1536"`。省略时根据语义自动选择。
- `parameters.watermark`（可选）：是否为输出图像添加水印（`true` 或 `false`，默认值为 `false`）。

### 输出说明

- 轮询：读取 `status`；处理中 `result` 为 `[]`
- 成功：`result` 为 `[{ "type": "Image", "url": "...", "download_url": "..." }]`，响应中同时返回 `costUSD`（0.04 美元）

## 注意事项

- 两个步骤使用相同的 `task_id`；处理中 `result` 为 `[]`，请继续轮询
- `FAILED` 为终态，请检查请求参数、图像 URL 或内容审核错误
- `input` 和 `parameters` 是顶层同级字段，请勿相互嵌套