Qwen Image 2.1 Turbo

Qwen Image 2.1 Turbo 是阿里巴巴基于统一多模态扩散架构构建的高速、高性价比图像生成与编辑模型。专为快速推理、高并发与低延迟优化，支持文生图、图生图、指令图像编辑以及原生透明背景生成，最多可输入 10 张参考图像。支持 1:8 至 8:1 的任意宽高比，原生输出分辨率最高可达 2K（总像素范围在 512×512 至 2048×2048 之间）。

接口基础地址 (Base 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（处理中时为 []；状态为 SUCCEEDED 时，result 包含生成的资源并提供 costUSD 字段）。以下示例在两个步骤中复用相同的 task_id。

1. 提交任务

向提交端点发起生成请求。

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

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/aliyun/qwen-image-2-1-turbo \
  -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": false,
    "size": "1024*1024"
  }
}'

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"}'

请求参数格式 (Input Schema)

提交任务 — 输入

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

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

inputobject必填

图像生成输入负载。

parametersobject

生成参数配置。

查询任务结果 — 输入

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

task_idstring必填

从提交端点返回的任务 ID。

响应数据格式 (Output Schema)

提交任务 — 输出

总计：1 项

task_idstring

异步任务唯一标识符。

查询任务结果 — 输出

总计：动态

statusstring

当前任务状态。任务未完成前 result 通常为 []；SUCCEEDED 状态下包含生成的资源及 costUSD 费用。

SUBMITTEDSUCCEEDEDFAILED

resultarray[object]

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

costUSDnumber

任务产生的美元费用（单次生成成功为 $0.016）。仅在 status 为 SUCCEEDED 时返回。

智能体提示词 (LLM Prompt)

下方 Markdown 为针对大语言模型优化的提示词，可直接复制粘贴至 AI 助手（如 Cursor、ChatGPT）中，帮助其快速理解该模型的 API、调用流程与关键参数。点击 复制给 AI 或从下方代码块中复制。

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

> Qwen Image 2.1 Turbo 是阿里巴巴轻量、高速的图像生成与编辑模型，提供统一的文生图、多参考图编辑及原生 2K 分辨率支持。

## 概述

采用 iCreat 两步异步任务 API：先提交生成请求，再轮询任务结果查询端点；成功后从 `result` 读取资源（附带 `costUSD` 字段）。

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **任务提交端点 (POST)**：`/v1/task/submit/aliyun/qwen-image-2-1-turbo`
- **结果查询端点 (POST)**：`/v1/task/result`
- **模型 ID**：`aliyun/qwen-image-2-1-turbo`
- **认证方式**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **提交任务**：按输入说明向提交路径发起 POST 请求；获取响应 `{ "task_id": "..." }`
2. **查询结果**：携带 `{ "task_id": "..." }` 向 `/v1/task/result` 发起 POST 请求；响应包含 `status` 与 `result`（处理中为 `[]`）；状态为 `SUCCEEDED` 时返回资源与 `costUSD`；当 `type` 为 `Image` 时读取 `url` 或 `download_url`

### 输入说明

- 顶级请求体：`input`（对象）与 `parameters`（对象）为同级结构
- `input.messages`（必填）
- `input.messages[].role`（必填）：消息角色（`user`）。
- `input.messages[].content`（必填）：包含 `{ "text": "..." }` 和/或 `{ "image": "..." }` 的数组（最多支持 10 张图）
- `input.messages[].content[].text`（可选）：文本提示词或编辑指令。
- `input.messages[].content[].image`（可选）：用于图像编辑 / 图生图的参考图片 URL。
- `parameters.size`（可选）：输出图像尺寸（如 `"1024*1024"`、`"2048*2048"`、`"2688*1536"`），总像素须在 512×512 至 2048×2048 范围内。
- `parameters.watermark`（可选）：是否添加水印（默认为 `false`）。

### 输出说明

- 轮询：读取 `status`；处理中时 `result` 为 `[]`
- 成功：`result` 为 `[{ "type": "Image", "url": "...", "download_url": "..." }]`，附带 `costUSD`（$0.016）

## 注意事项

- 两个步骤必须使用同一个 `task_id`；处理中时 `result` 为 `[]`，需持续轮询
- `FAILED` 表示最终失败状态——请检查请求参数或参考图像资源
- `input` 与 `parameters` 为同级顶层字段，切勿相互嵌套