API 文档中文 Markdown

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>。

文生图:

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

图生图:

{
  "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。