Qwen-Image Max API

价格

费用 = 每张图片积分 × n。提交任务时预留积分；任务失败，或你在开始前取消，积分全额退回。

速览

快速开始

在控制台创建密钥，然后提交任务并轮询。第二个请求里的 id 换成第一个请求返回的那个。

curl -s -X POST https://api.genmux.tech/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen-image-max","prompt":"a red fox in fresh snow, low winter sun","n":1,"resolution":"1K","ratio":"1:1"}'

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "qwen-image-max",
  "status": "queued",
  "params": {"prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
  "cost": 8,
  "created_at": "2026-08-30T20:01:12.345Z"
}

curl -s https://api.genmux.tech/v1/generations/0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d \
  -H "Authorization: Bearer $API_KEY"

{
  "id": "0d8b6a3e-2f1c-4a5b-9c1d-7e2f3a4b5c6d",
  "model": "qwen-image-max",
  "status": "succeeded",
  "cost": 8,
  "images": [
    {"index": 0, "url": "https://…/0.png?X-Amz-Expires=900&…", "expires_at": "2026-08-30T20:16:30Z", "mime": "image/png", "width": 1024, "height": 1024, "bytes": 1843201, "sha256": "9f2c…"}
  ],
  "created_at": "2026-08-30T20:01:12.345Z",
  "finished_at": "2026-08-30T20:01:19.802Z"
}

import os, time, uuid, requests

BASE = "https://api.genmux.tech"
auth = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

job = requests.post(
    f"{BASE}/v1/generations",
    headers={**auth, "Idempotency-Key": str(uuid.uuid4())},
    json={"model": "qwen-image-max", "prompt": "a red fox in fresh snow, low winter sun", "n": 1, "resolution": "1K", "ratio": "1:1"},
    timeout=30,
).json()

while job["status"] in ("queued", "running"):
    time.sleep(1)
    job = requests.get(f"{BASE}/v1/generations/{job['id']}", headers=auth, timeout=30).json()

print(job["images"][0]["url"])  # presigned, valid for 15 minutes

const BASE = "https://api.genmux.tech";
const auth = { Authorization: `Bearer ${process.env.API_KEY}` };

let job = await fetch(`${BASE}/v1/generations`, {
  method: "POST",
  headers: { ...auth, "Idempotency-Key": crypto.randomUUID(), "Content-Type": "application/json" },
  body: JSON.stringify({ model: "qwen-image-max", prompt: "a red fox in fresh snow, low winter sun", n: 1, resolution: "1K", ratio: "1:1" }),
}).then((r) => r.json());

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 1000));
  job = await fetch(`${BASE}/v1/generations/${job.id}`, { headers: auth }).then((r) => r.json());
}

console.log(job.images[0].url); // presigned, valid for 15 minutes

常见问题

Qwen-Image Max API 是什么？

Qwen-Image Max 是阿里 Qwen-Image 系列的旗舰——同样围绕画面内可读文字（包括中文）和参考图编辑构建，处在阿里为该系列提供的最高画质档位。在 genmux API 上，这套 Qwen-Image API 以模型标识 "qwen-image-max" 提供。它输出 1K, 2K，每次请求最多接受 4 张参考图，并且只接受固定的一组宽高比：16:9, 4:3, 1:1, 3:4, 9:16。

一张 Qwen-Image Max 图片多少钱？

每张 8 积分起，约合 $0.10，按「Scale」套餐单价计算。价格随分辨率档位变化：1K — 8 积分 · 2K — 9 积分。请求 n 张就是单张价格的 n 倍。积分是预付的，没有订阅费，也不按人头收费。

Qwen-Image Max 和 Qwen-Image 2.0 有什么区别？

Max 是同一系列的更高档位，单张价格也更高：1K — 8 积分 · 2K — 9 积分。它的宽高比列表更窄，其余请求字段与 2.0 完全相同，所以切换只需一个字段。与 Nano Banana Pro 相比则是另一种取舍：Nano Banana Pro 提供更高的分辨率档位，而当画面成败取决于排版文字或参考图编辑时，该选 Max。Max 输出 1K, 2K。

为什么 Qwen-Image Max 支持的宽高比更少？

因为上游模型只以固定的几种画幅提供服务：16:9, 4:3, 1:1, 3:4, 9:16，没有 "auto"。不在列表内的比例会以 400 validation_error 拒绝，而不是近似处理，这样你永远不会为一个自己没要的画幅付费。如果你需要特殊画幅，请挑一个规格表里列出该比例的模型——GET /v1/models 会返回每个模型的比例——或者用最接近的比例生成后自行裁切。

Qwen-Image Max 支持哪些分辨率？

分辨率是档位而不是具体像素：这个模型可输出 1K, 2K，不传 resolution 字段时默认 1K。不在列表内的档位会以 400 validation_error 拒绝，而不是悄悄降采样，所以你始终清楚自己付的是哪一档的价。旧的 size 字段（"1024x1024"）为兼容已有接入仍可使用，会映射到最接近的档位和比例。

可以指定哪些宽高比？

16:9, 4:3, 1:1, 3:4, 9:16。通过 ratio 字段传入，默认 1:1。不在列表内的比例会返回 400 validation_error。比例不影响价格，只有分辨率档位影响。

可以传参考图吗（图生图）？

可以。把 images 传成公开 https URL 的数组——每次请求最多 4 张——这时提示词描述的是修改或变体，而不是整个画面；有参考图时提示词本身可选。URL 必须能从公网访问：内网地址和非 https 的 URL 会以 400 validation_error 拒绝。

有反向提示词吗？

有。在 prompt 之外传 negative_prompt，用来描述画面里不想要的东西——瑕疵、文字、水印、想避开的颜色。不额外收费。

一次请求能生成多少张？

每次调用最多 4 张，通过 n 字段指定。每张单独计费，所以在 1K 下 n=4 就是单张价格的 4 倍。要出更大批量请提交多个任务——限制吞吐的是账户在途任务上限（默认 20），不是 n。

生成结果可复现吗？支持随机种子吗？

支持。在提示词之外传一个整数 seed，相同的种子配相同的提示词、分辨率和比例就能复现结果——这也是公平对比两个模型的方法。不传则每次独立采样。

一次生成要多久？必须轮询吗？

从提交到 succeeded 通常 1–20 秒，取决于分辨率档位和队列深度。这套 API 是异步的：POST /v1/generations 在毫秒级返回任务 id，之后你要么轮询 GET /v1/generations/{id}，要么传 webhook_url 让我们在任务完成时 POST 通知你，失败按退避重试最多 8 次直到你的接口返回 2xx。每次投递都带 HMAC-SHA256 签名，用你的账户 webhook 密钥验证。

生成失败会怎样？

不会扣费。积分在任务创建时预留，若任务失败、在排队阶段被取消，或模型暂时不可用（503 model_unavailable），都会全额退回。失败的任务会带一个 error 对象，其中的 code（例如 content_policy）方便你分支处理。

重试时怎么避免重复扣费？

每个 POST /v1/generations 都必须带 Idempotency-Key 请求头。用同一个 key 重发会以 200 返回原来的任务，不会再扣费，所以网络超时可以放心重试。用同一个 key 配不同的请求体会被 422 idempotency_key_mismatch 拒绝。

生成的图片能商用吗？

可以——根据我们的服务条款，我们能转让的权利归你所有，可用于商业用途，前提是提示词和用途符合条款以及上游模型供应商的内容政策。面向客户发布之前请先阅读条款。

延伸阅读

• genmux MCP 服务器：在 Claude、Cursor 和 OpenCode 里出图

  一条 npx 命令安装 @genmux/mcp，让 Claude、Cursor、OpenCode 或 Continue 列出模型、预估费用并生成 Nano Banana 图片。

  2026年9月7日

• 图像生成流水线的速率限制与排队

  设计一条扛得住流量高峰的图像生成流水线：单密钥 RPS、最大在途任务数、客户端排队、退避策略和容量计算。

  2026年8月30日

• Nano Banana 与 Nano Banana Pro：什么时候值得多花一倍

  两个 Nano Banana 模型的实用对比：画质、提示词还原、支持的分辨率、延迟和成本，并按使用场景给出具体建议。

  2026年8月30日

其他模型

同一个密钥、同一种请求格式——改一下 model 字段就能切换。

• Nano Banana API

  nanobanana

  快速的通用文生图与图生图模型，输出 1K，只需一个 HTTP 接口。按张用积分计费，任务失败自动退回积分。

  每张 2 积分 ≈ $0.025 起

• Nano Banana Pro API

  nanobanana-pro

  更高保真度的生成模型，适合主视觉和印刷尺寸的画面，支持 1K、2K 和 4K 输出——1K 档的单张价格约为基础版的两倍。

  每张 4 积分 ≈ $0.05 起

• Qwen-Image 2.0 API

  qwen-image-2

  阿里的 Qwen-Image 2.0——围绕画面内可读文字（包括中文）设计的图像模型，支持参考图输入，输出 1K 或 2K。

  每张 3 积分 ≈ $0.038 起

• Seedream 5.0 API

  seedream-5

  字节跳动 Seedream 5.0——面向写实画面和画面内文字的高分辨率模型，仅提供 2K 和 4K。支持参考图，按张用积分计费。

  每张 16 积分 ≈ $0.20 起

• Wan 2.7 Image API

  wan-2-7-image

  阿里通义万相系列的 wan2.7-image——文生图与参考图生成，输出 1K 或 2K，与这里其他模型共用同一接口和 API 密钥。

  每张 2 积分 ≈ $0.025 起