# qwen image global 2.1

模型 ID：`qwen-image-global-2.1`。同一接口支持文生图和图生图：不传参考图时为文生图，
传入 1–10 张参考图时为图生图。每个任务生成一张图，两种模式同价：

| 分辨率 | 每张价格 |
| --- | --- |
| 1K | ¥0.10 |
| 2K（默认） | ¥0.20 |
| 4K（最高） | ¥0.40 |

已使用海外应用。分辨率改用 `metadata.resolution`，不再接受 `metadata.megapixels`。
图片长边不超过所选档位的 1024、2048、4096 像素；实际尺寸随比例和工作流对齐略有变化。

提交：`POST /v1/image/generations`；查询：`GET /v1/image/generations/{id}`。
使用站内 API Key 作为 `Authorization: Bearer <API_KEY>`。

文生图：

```json
{
  "model": "qwen-image-global-2.1",
  "prompt": "一块白板，上面清晰地写着 qwen image global 2.1",
  "metadata": { "ratio": "3:4", "resolution": "2k" }
}
```

图生图：

```json
{
  "model": "qwen-image-global-2.1",
  "prompt": "保留主体，将背景改为蓝色",
  "images": ["https://cdn.example.com/reference.png"],
  "metadata": { "ratio": "1:1", "resolution": "4k", "seed": 0 }
}
```

| 字段 | 范围与默认值 |
| --- | --- |
| `prompt` | 必填，非空提示词 |
| `images` | 可选，0–10 张参考图 URL，按传入顺序使用 |
| `metadata.ratio` | `1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9`；默认 `3:4` |
| `metadata.resolution` | `1k / 2k / 4k`，默认 `2k`，最高 `4k` |
| `metadata.seed` | 可选，整数 0–9007199254740991；不传则随机，显式 0 有效 |
| `n` | 仅支持 1；多图请分别提交任务 |

查询成功后，主图片 URL 位于 `data.result_url`。原始内容的主图片位于
`data.data.content.image_url`；若有多张输出，完整有序列表位于
`data.data.content.image_urls`。最终费用见 `data.usage.amount` 和
`data.usage.currency`，以成功生成的图片数结算。

文生图无需上传图片；图生图素材可先通过 `/v1/files/upload` 上传后使用返回的 URL。