> ## 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 3.0 & Qwen Image 3.0 Pro

Qwen-Image-3.0 支持最大 4.5k token 输入，支持图中图密集信息排版，让报纸、分镜、菜单、试卷等复杂版面一次生成。 细节真实：支持 10px 小字精准渲染，微表情、毛孔、发丝等细节生动还原，逼近真实摄影的质感。知识厚实：支持 12 国语言、20+ 字体原生渲染，主流网页、游戏、直播等界面仿真，外部知识全纳入。

Qwen-Image-3.0-Pro 不只是在追求"好看"，更在追求“好用”——让图像生成真正成为可落地的生产力工具。

### 模型参数

* 模型 ID：`qwen-image-3.0`/`qwen-image-3.0-pro`
* 模型价格：你可以在模型详情页查看最新价格信息👉[Qwen-Image-3.0](https://geekai.co/models/qwen-image-3.0)、[Qwen-Image-3.0-pro](https://geekai.co/models/qwen-image-3.0-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`

  附：[千问图像生成与编辑 3.0 官方 API 文档](https://bailian.console.aliyun.com/cn-beijing?spm=5176.12818093_47.overview_recent.1.2ffa2cc9sPpVb6\&tab=api#/api/?type=model\&url=3047054)
</Note>

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

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

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

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

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

* 支持的图片格式：PNG、JPG、JPEG、WEBP；
* 图片大小限制：单张图片不超过 10MB；
* 图片分辨率：建议图像的宽和高均在384像素至2048像素之间。

### 模型价格

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

| 模型ID                 | 分辨率 | 价格（单位：元/张） |
| -------------------- | --- | ---------- |
| `qwen-image-3.0`     | 1K  | 0.18       |
| `qwen-image-3.0`     | 2K  | 0.18       |
| `qwen-image-3.0-pro` | 1K  | 0.25       |
| `qwen-image-3.0-pro` | 2K  | 0.5        |

不同于 GPT-Image-2 按 tokens 计费，Qwen-Image-3.0 按图片宽高总像素对输出图片分档次计费，以图片总像素2250000像素为分界线，超过该像素的图片按 2K 分辨率计费，低于（含）该像素的图片按 1K 分辨率计费。

`qwen-image-3.0` 1K 和 2K 分辨率价格一样，`qwen-image-3.0-pro` 2K 分辨率价格是 1K 的 2 倍。两个模型都对输入的参考图计费，单价为 0.02 元/张。

### 文生图

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

```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-3.0",
    "prompt": "一副典雅庄重的对联悬挂于厅堂之中，房间是个安静古典的中式布置，桌子上放着一些青花瓷，对联上左书“义本生知人机同道善思新”，右书“通云赋智乾坤启数高志远”， 横批“智启通义”，字体飘逸，在中间挂着一幅中国风的画作，内容是岳阳楼。",
    "size": "1024x1024",
    "negative_prompt ": "低分辨率，低画质，肢体畸形，手指畸形，画面过饱和，蜡像感，人脸无细节，过度光滑，画面具有AI感。构图混乱。文字模糊，扭曲。",
    "watermark": false
}'
```

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

```json theme={null}
{
  "model": "qwen-image-3.0",
  "created": 1785944071,
  "task_id": "8b5dbd66-0ebf-430e-b643-ffc2de28f05e",
  "task_status": "succeed",
  "data": [
    {
      "url": "https://static.geekai.co/image/2026/08/05/fe873826fecd34854a3c04a56f468a2d.png",
      "base64": "...base64 encoded image data..."
    }
  ],
  "usage": {
    "billed_units": 1,
    "output_image_type": "qima_output_1k"
  }
}
```

这里 `billed_units` 表示生成图片的计费数量，`output_image_type` 表示输出图片的分辨率类型，`qima_output_1k` 表示输出图片的分辨率为 1K，`qima_output_2k` 表示输出图片的分辨率为 2K。

### 图生图

**单图**

通过 `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-3.0",
    "prompt": "生成一张符合深度图的图像，遵循以下描述：一辆红色的破旧的自行车停在一条泥泞的小路上，背景是茂密的原始森林",
    "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp",
    "negative_prompt ": "低质量"
}'
```

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

```json theme={null}
{
    "model": "qwen-image-3.0",
    "created": 1785944426,
    "task_id": "c9c2bdf8-1403-4d42-aa76-062b4dff5949",
    "task_status": "succeed",
    "data": [
        {
            "url": "https://static.geekai.co/image/2026/08/05/338d11a35ef558fb5fff218a605255a5.png",
            "base64": "...base64 encoded image data..."
        }
    ],
    "usage": {
        "billed_units": 1,
        "output_image_type": "qima_output_2k"
    }
}
```

**多图**

通过 `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-3.0",
    "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",
    ]
}'
```