Qwen Image 2.1

选择输入和尺寸

公开模型别名为 qwen-image-2.1。使用个人 Account API Key 调用 POST /images/generations；创建返回 202 后等待任务终态。文字生图不传参考图，编辑与参考创作使用 1–10 张有序图片；提示词可按“图1”“图2”指代数组中的图片。

prompt 必填，最多 10,000 个 Unicode 字符。每次固定生成一张 PNG，Turbo 固定 8 步、CFG=1；不开放非空负面提示词。可省略 steps、guidance_scale 和生成张数，不要通过这些字段调整执行方式。

seed 可选，范围为 0–2147483647；省略时平台生成并记录实际种子。同种子用于重复同一输入，不承诺跨运行条件逐像素一致。默认输出为 1024×1024，参考图不会自动改变所选输出尺寸。

size 使用表中的 宽x高，例如 1376x768。当前只开放以上 14 个尺寸，不接受任意宽高。

文字生图

设置 JUSP_BASE_URL=https://api.jusuanhub.com/v1，JUSP_API_KEY 使用当前调用者自己的 Key。不要把 Key 写进代码仓库或浏览器页面。

curl --fail-with-body --max-time 120 \
  "$JUSP_BASE_URL/images/generations" \
  -H "Authorization: Bearer $JUSP_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: qwen-image-text-001' \
  -d '{"model":"qwen-image-2.1","prompt":"清晨的山间湖泊，远山倒映，柔和自然光","size":"1376x768","seed":42}' \
  -o create.json

这里的幂等键代表一次不变的业务动作。重试相同动作保留原键和正文；修改提示词、图片或尺寸后使用新的业务键。

单图编辑与多图参考

每张参考图先用同一个 Key 上传，查询参数 model 指向本模型：

curl --fail-with-body --max-time 120 \
  "$JUSP_BASE_URL/assets/input?model=qwen-image-2.1" \
  -H "Authorization: Bearer $JUSP_API_KEY" \
  -F 'image=@reference.png' -o upload.json

保存响应的 asset.assetId。单图编辑请求如下；将占位符换成已上传且当前身份可用的 Asset ID：

{
  "model": "qwen-image-2.1",
  "prompt": "保留图1的主体，将背景改为浅蓝色摄影棚。",
  "size": "2048x2048",
  "seed": 42,
  "input_image_asset_ids": ["<ASSET_1>"]
}

多图使用同一接口和字段，按提示词中的引用顺序逐项传入。两张示例：

{
  "model": "qwen-image-2.1",
  "prompt": "将图1的人物放入图2的场景，保留人物特征，统一光线。",
  "size": "1376x768",
  "input_image_asset_ids": ["<ASSET_1>", "<ASSET_2>"]
}

十张参考图仍是一个任务，数组完整保留，不拼图或静默截断：

{
  "model": "qwen-image-2.1",
  "prompt": "按图1到图10顺序，以各图主体为元素创作一张协调的展览海报。",
  "size": "2048x2048",
  "input_image_asset_ids": [
    "<ASSET_1>", "<ASSET_2>", "<ASSET_3>", "<ASSET_4>", "<ASSET_5>",
    "<ASSET_6>", "<ASSET_7>", "<ASSET_8>", "<ASSET_9>", "<ASSET_10>"
  ]
}

图片限 PNG、JPEG、静态 WebP；单张最大 16 MiB、最长边 5760、最多 40,000,000 像素、宽高比不超过 200:1。平台还校验参考图与输出图的联合预算，极端比例或复杂组合即使不足十张也可能被拒绝。传递原文件的 MIME，不通过改扩展名绕过校验；不接受任意 URL、文件路径或直接 base64。Asset 有效期与归属规则见素材输入。

查询、下载与失败恢复

保存创建响应中的 jobId 和 jobUrl，携带原 Key 查询；等价查询路径为 GET /jobs/{jobId}?model=qwen-image-2.1。queued、running 继续等待，succeeded 后读取 outputs[0].contentUrl 并携带原 Key 下载。输出为 PNG；下载失败只重试领取原结果，不重新生成。

完整的有界轮询、同源 URL 检查和下载示例见 API Key 异步媒体完整调用与任务恢复。failed 是业务终态，读取错误码后再由用户决定下一次调用。429 按 Retry-After 退避；超时或断网不表示服务端未受理，先恢复原任务。当前不支持主动取消运行中的生成。

提示词优化与费用

提示词优化为手动可选。使用独立优化入口得到 optimization.optimizedPrompt 文本，用户确认后再将其放入本次生成请求的 prompt；保留已选 size，不会默认自动生成。优化遵循 Qwen 官方改写规则，模型正文直接返回文本，不要求 H3 的结构化 JSON 或修复流程。

带图优化按原顺序转交全部参考图；优化模型有自己的输入上限，超限错误原样反馈，不会丢图。生成支持十图不代表当前优化模型也能接受十图；优化失败可由用户保留原文继续创建生成任务。优化单独按所用 Qwen3.8 模型计费，和后续生图是两次独立调用。

高清标价 8 积分/张，超清标价 16 积分/张。适用全局五折时为 4/8 积分/张；具体折扣和最终扣费以调用者当时有效价格及回执为准。参考图数量不增加输出张数；输入不合规不应反复提交，受理、预占、释放与实际结算是不同状态，不能把失败或账务待确认当作“已扣零积分”。