Qwen-Image API 指南

Q: Qwen-Image 可以直接用 OpenAI SDK 调用吗？

可以。把 `base_url` 设为 https://sub.sumcapi.top/v1、`api_key` 换成苏姆卡皮密钥即可；如需 Anthropic 原生契约，用 `/v1/messages`。

Q: 模型广场里看不到 Qwen-Image 怎么办？

说明当前分组未包含该模型或上游暂时未开放。可换一个分组、联系管理员开通，或选择同能力的兜底模型，见 [模型广场](/model-plaza)。

Q: Qwen-Image 怎么计费？

口径是按 张 或按 任务 计费，分辨率与质量档位决定单价，明细见 [模型定价](/pricing)。；实际倍率与单价以控制台实时展示为准，详见 [模型定价](/pricing)。

苏姆卡皮 · 图像生成与编辑 · 厂商阿里云 · Base URL https://sub.sumcapi.top/v1 · 更新于 2026-09-10

30 秒结论

它擅长什么：通义图像模型，对中文文字排版与海报类构图支持较好，走 /v1/images/generations 一个端点即可开始。
怎么接：把 OpenAI SDK 的 base_url 改成 https://sub.sumcapi.top/v1，api_key 换成苏姆卡皮密钥，模型名填 Qwen-Image。
注意什么：图像生成与编辑以控制台与模型广场实时展示为准；生产链路请配置超时、退避与兜底模型。

接口与关键参数

鉴权统一使用 Authorization: Bearer <API_KEY>。返回的临时地址有有效期，请立刻转存到你自己的存储

参数	类型	必填	说明
`model`	string	是	图像模型标识
`prompt`	string	是	提示词：主体、构图、光线、材质、风格逐项写清
`n`	integer	否	生成张数，按张计费
`size`	string	否	如 `1024x1024` / `1536x1024`，可用档位随模型而定
`quality`	string	否	`low` / `medium` / `high`，草稿用低档
`response_format`	string	否	`url`（默认，注意有效期）或 `b64_json`
`background`	string	否	设为 `transparent` 可输出透明底（模型支持时）
`image` / `mask`	file / base64	编辑时	图像编辑走 `/v1/images/edits`，传原图与可选蒙版

请求示例

cURL

curl https://sub.sumcapi.top/v1/images/generations \
  -H "Authorization: Bearer $SUMCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen-Image",
    "prompt": "白底商品图，柔光，俯视 45 度，细节清晰，画面内无文字",
    "size": "1024x1024",
    "n": 1
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(base_url="https://sub.sumcapi.top/v1", api_key="sk-你的密钥")
img = client.images.generate(
    model="Qwen-Image",
    prompt="赛博朋克城市夜景，霓虹，雨后地面反光",
    size="1024x1024",
    n=1,
)
print(img.data[0].url)   # 临时地址有有效期，请及时转存

响应要点

结果地址有有效期，落库前先下载转存。
建议记录请求 ID：排查问题与计费争议都需要它。
同名模型可能由不同渠道提供，输出风格会有细微差异，切模型前做一轮回归。

常见错误与处理

状态码 / 现象	通常原因	建议处理
`401`	密钥无效、已停用或余额为 0	检查密钥状态与余额；轮换密钥后重新加载配置
`403`	模型不在该密钥绑定的分组内	换模型，或在控制台把该模型所在分组授予此密钥
`404`	模型名或路径不存在	先 `GET /v1/models` 校对可用清单
`429`	触发 RPM / 并发 / 配额限制	指数退避 1s → 2s → 5s → 10s 并加抖动，不要无脑重试
`502` / `503` / `504`	上游暂时不可用或过载	网关会自动切换候选渠道；仍失败时切兜底模型并延长超时
内容策略拒绝	提示词命中上游限制	改写提示词通常比重试更快；避免真人、品牌与受限题材

计费口径

按张或按任务计费，分辨率与质量档位决定单价，明细见模型定价。
失败任务不计费；被内容策略拒绝的请求不产生账单条目。
先用低分辨率做风格探索，定稿再跑高分辨率，批量成本通常能降一个数量级。
生成与编辑价格不同，接口形状见图像 API。

适用场景

电商主图：白底、柔光、固定视角的模板化提示词，批量出图后人工挑选。
营销素材：封面、Banner、活动海报，配合文字渲染能力减少后期排版。
素材二次加工：局部重绘、换背景、换风格走图像编辑接口。
概念设计：风格探索阶段用低档参数快速试错。

选型建议

中文海报、带字素材。同一能力建议同时配置 2 个以上候选模型，网关会在限流与过载时自动切换，见路由与错误。

接入三步

在控制台创建密钥并绑定包含该模型的分组；
用上面的示例跑通一次最小请求，确认 model 返回模型名；
把 model 做成配置项，在模型广场对照可用清单，逐步迁移业务链路。

模型	能力	定位
GPT Image 1	图像生成与编辑	OpenAI 图像模型，支持文生图与基于蒙版的编辑，可输出透明底
DALL·E 3	图像生成与编辑	上一代图像模型，生态兼容性好，适合风格化插画
Gemini 2.5 Flash Image	图像生成与编辑	Google 图像生成与编辑模型，多轮指令改图与主体一致性好
FLUX1.1 Pro	图像生成与编辑	FLUX 系列高质量图像模型，写实与构图控制受好评
FLUX Kontext Pro	图像生成与编辑	支持指令式图像编辑与生成，改图链条更稳
Seedream 4.0	图像生成与编辑	即梦图像模型，中文语义与细节纹理表现好
Nano Banana	图像生成与编辑	轻量图像编辑模型的社区常用称呼，改图与合成成本低
Ideogram 3	图像生成与编辑	以图中文字渲染见长，适合带标语的海报与封面

常见问题

Qwen-Image 可以直接用 OpenAI SDK 调用吗？

可以。把 base_url 设为 https://sub.sumcapi.top/v1、api_key 换成苏姆卡皮密钥即可；如需 Anthropic 原生契约，用 /v1/messages。

模型广场里看不到 Qwen-Image 怎么办？

说明当前分组未包含该模型或上游暂时未开放。可换一个分组、联系管理员开通，或选择同能力的兜底模型，见模型广场。

Qwen-Image 怎么计费？

口径是按张或按任务计费，分辨率与质量档位决定单价，明细见模型定价。；实际倍率与单价以控制台实时展示为准，详见模型定价。

调用报 429 怎么处理？

触发的是分组 RPM / 并发限制。按 1s → 2s → 5s 指数退避并加抖动，必要时提高分组限额或增加兜底模型。