> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokensmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 生成图像

## (百炼 Qwen-Image 系列)

通过通义千问百炼系列的 Qwen-Image 模型生成图片。该接口支持提示词自动优化和中式风格的深度理解。

***

### 基础信息

* **接口地址**: `POST /v1/images/generations`
* **认证方式**: `Bearer Token`
* **内容类型**: `application/json`

### 模型概览

| **模型名称**                    | **模型简介**                                                                | **输出图像格式**                                                    |
| --------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------- |
| wan2.6-t2i `**推荐**`         | 万相2.6 支持在总像素面积与宽高比约束内，自由选尺寸（同wan2.5）                                    | 图像分辨率：总像素在\[1280*1280, 1440*1440]之间图像宽高比：\[1:4, 4:1] 图像格式：png |
| wan2.5-t2i-preview `**推荐**` | 万相2.5 preview 支持在总像素面积与宽高比约束内，自由选尺寸 （例如，支持768\*2700，而2.2及以下版本单边上限 1400） |                                                               |
| wan2.2-t2i-flash            | 万相2.2极速版 较2.1模型速度提升50%                                                  | 图像分辨率：宽高均在\[512, 1440]像素之间 图像格式：png                           |
| wan2.2-t2i-plus             | 万相2.2专业版  较2.1模型稳定性与成功率全面提升                                             |                                                               |
| wanx2.1-t2i-turbo           | 万相2.1极速版                                                                |                                                               |
| wanx2.1-t2i-plus            | 万相2.1专业版                                                                |                                                               |
| wanx2.0-t2i-turbo           | 万相2.0极速版                                                                |                                                               |

### 请求参数 (Request Body)

| 参数名                     | 类型        | 必选    | 描述                                                                                                                         |
| :---------------------- | :-------- | :---- | :------------------------------------------------------------------------------------------------------------------------- |
| **model**               | `string`  | **是** | 模型名称，例如：`qwen-image-plus` 或 `qwen-image-max`。                                                                              |
| **content**             | `string`  | **是** | 图像描述文本                                                                                                                     |
| **parameters**          | `object`  | 否     | 控制生成效果的参数对象。                                                                                                               |
| └─ **negative\_prompt** | `string`  | 否     | 反向提示词，指定不希望在图像中出现的内容。                                                                                                      |
| └─ **prompt\_extend**   | `boolean` | 否     | 是否开启 AI 自动优化提示词（默认为 true）。                                                                                                 |
| └─ **watermark**        | `boolean` | 否     | 是否在生成图中添加水印。                                                                                                               |
| └─ **size**             | `string`  | 否     | 图像尺寸，例如 `1328*1328`、`1024*1024` 宽度和高度范围都要在 512-1440之间。                                                                     |
| └─ **n**                | `integer` | 否     | 生成图片的数量。取值范围为1\~4张，默认为`4`。注意：按张计费，测试建议设为 1。                                                                                |
| └─ **seed**             | `integer` | 否     | 随机数种子，取值范围`[0,2147483647]`。 使用相同的`seed`参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。**注意**：模型生成过程具有概率性，即使使用相同的`seed`，也不能保证每次生成结果完全一致。 |

***

### 响应结果 (Response)

**状态码: 200 OK**

| 字段名                    | 类型        | 描述                       |
| :--------------------- | :-------- | :----------------------- |
| **created**            | `integer` | 创建时的 Unix 时间戳。           |
| **data**               | `array`   | 生成结果列表。                  |
| └─ **url**             | `string`  | 生成图像的下载链接。               |
| └─ **b64\_json**       | `string`  | 图像的 Base64 编码数据（如果要求返回）。 |
| └─ **revised\_prompt** | `string`  | AI 自动优化后的最终提示词内容。        |

***

### 请求示例

```json theme={null}
{
    "model": "wan2.2-t2i-flash",
    "prompt": "一只小猫在草地上奔跑，电影感，光影自然",
    "parameters":{
        "size": "960*1390"
    }
}
```

### 📝 返回示例

```json theme={null}
{
  "created": 1713833628,
  "data": [
    {
      "url": "https://example.com/qwen_output_image.png",
     	"b64_json": "",
      "revised_prompt": ""
    }
  ]
}
```

***

### 💡 开发者建议

1. **文字理解**: Qwen 系列模型对中文成语、对联及中式意境（如岳阳楼、青花瓷）有极佳的还原能力。
2. **提示词优化**: 建议保持 `prompt_extend: true`，这能让生成的画面细节更丰富。