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

# Qwen Image 2.1

qwen-image-2.1-pro：速度、效果、成本最均衡。图生图支持传入最多10张参考图，能根据提示词自动决定输出普通图像或带透明通道的图像。

qwen-image-2.1-turbo：极致性价比，Qwen-Image系列中综合性价比最优。图生图支持传入最多10张参考图，能根据提示词自动决定输出普通图像或带透明通道的图像。

### 模型参数

* 模型 ID：`qwen-image-2.1-turbo`/`qwen-image-2.1-pro`
* 模型价格：你可以在模型详情页查看最新价格信息👉[Qwen-Image-2.1-turbo](https://geekai.co/models/qwen-image-2.1-turbo)、[Qwen-Image-2.1-pro](https://geekai.co/models/qwen-image-2.1-pro)
* 调用入口：`https://geekai.co/api/v1/images/generations`
* 模型参数：参考[画图 API 手册](https://docs.geekai.co/cn/api/image/generations)
* API 认证：[获取 API KEY](https://geekai.co/user/api_keys)

> [!NOTE]
>
> 不支持画图 API 中的以下参数：
>
> * `strength`
> * `aspect_ratio`
> * `quality`
> * `style_preset`
> * `response_format`
> * `output_format`
> * `mask`
> * `background`
>
> 附：[千问图像生成与编辑 2.1 官方 API 文档](https://docs.bailian.console.aliyun.com/zh/model-studio/qwen-image-generation-and-editing-api-reference)

支持通过 `size` 字段实现输出图像的分辨率，格式为`宽x高`，例如"1024x1024"，未指定时由模型根据提示词自动推荐分辨率：

* 文生图（T2I）：像素面积范围 `512x512` 至 `2048x2048` 之间的任意尺寸，宽高比限制 `1:8` 至 `8:1`；
* 图生图（I2I）：像素面积范围 `512x512` 至 `2048x2048` 之间的任意尺寸，宽高比限制 `1:8` 至 `8:1`。

极客智坊支持通过 `enhance_prompt` 字段替代官方的 `prompt_extend` 对提示词进行扩写增强，增强后的提示词会在原始提示词的基础上进行优化，提升生成图像的质量和细节表现。

支持通过 `extra_body.prompt_extend_mode` 字段指定提示词优化模式，可选值包括：

* `direct`：默认值。直接提示词增强（DPE），适用于大多数场景，文生图和图生图均支持。
* `agent`：智能体提示词增强（APE），提供更精细的改写效果。仅支持文生图，图生图场景传入 `agent` 将返回 `400` 错误。

支持通过 `n` 字段指定生成图像的数量，最大支持 6 张，默认值为 1 张。

图生图场景支持通过 `image` 字段传入参考图，支持 URL 或 Base64 编码的图片数据，最大支持 10 张，多张图片通过数组传递即可。图像要求如下：

* 支持的图片格式：PNG、JPG、JPEG、WEBP、BMP、TIFF和GIF；
* 图片大小限制：单张图片不超过 10MB，长边与短边之比不超过10:1；
* 图片分辨率：建议图像的宽和高均在384像素至2048像素之间以获取最佳效果。

支持通过 `extra_body.enable_thinking` 字段开启思考模式，默认为 `true`，仅在 `enhance_prompt=true` 时生效，开启会提升出图质量，同时会增加耗时。

### 模型价格

和 GPT-Image-2 类似，Qwen-Image-2.1 支持 `512x512` 至 `2048x2048` 的任意分辨率图片生成，以下是价格表：

| 模型ID | 价格（单位：元/张） |
| - | - |
| `qwen-image-2.1-turbo` | 0.1 |
| `qwen-image-2.1-pro` | 0.25 |

生成图片价格统一按张计算，与图片尺寸和质量无关。

### 文生图

通过给模型提供清晰准确的文字指令，即可快速获得符合描述的高质量图片：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "qwen-image-2.1-turbo",
    "prompt": "一副典雅庄重的对联悬挂于厅堂之中，房间是个安静古典的中式布置，桌子上放着一些青花瓷，对联上左书“义本生知人机同道善思新”，右书“通云赋智乾坤启数高志远”， 横批“智启通义”，字体飘逸，在中间挂着一幅中国风的画作，内容是岳阳楼。",
    "size": "1024x1024",
    "negative_prompt ": "低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感，人脸无细节，过度光滑，画面具有AI感。构图混乱。文字模糊，扭曲。",
    "watermark": false
}'
```

要开启提示词增强，可以通过将 `enhance_prompt` 字段设置为 `true`：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "qwen-image-2.1-turbo",
    "prompt": "一副典雅庄重的对联悬挂于厅堂之中，房间是个安静古典的中式布置，桌子上放着一些青花瓷，对联上左书“义本生知人机同道善思新”，右书“通云赋智乾坤启数高志远”， 横批“智启通义”，字体飘逸，在中间挂着一幅中国风的画作，内容是岳阳楼。",
    "size": "1024x1024",
    "negative_prompt ": "低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感，人脸无细节，过度光滑，画面具有AI感。构图混乱。文字模糊，扭曲。",
    "enhance_prompt": true,
    "extra_body": {
        "prompt_extend_mode": "agent"
    },
    "watermark": false
}'
```

响应是一个包含生成图片的 URL 和 Base64 编码图片数据的 JSON 对象：

```json theme={null}
{
    "model": "qwen-image-2.1-turbo",
    "created": 1792549242,
    "task_id": "0c1be9e7-cd28-4e22-9e65-a21dd379d80a",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/10/21/575a8737fda209b77bd18535ebb66cfc.png"
        }
    ],
    "usage": {
        "billed_units": 1
    }
}
```

这里 `billed_units` 表示生成图片的计费数量。

### 图生图

**单图**

通过 `image` 传入单图即可实现基于参考图生成图像或者图片编辑：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "qwen-image-2.1-turbo",
    "prompt": "生成一张符合深度图的图像，遵循以下描述：一辆红色的破旧的自行车停在一条泥泞的小路上，背景是茂密的原始森林",
    "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp",
    "negative_prompt ": "低质量"
}'
```

**多图**

通过 `image` 传入多图即可实现基于多张参考图生成图像：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "qwen-image-2.1-turbo",
    "prompt": "将图2女生的服装换为图1女生的服装",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png", 
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png",
    ]
}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.