2026 图生图接口怎么接入：千问-image-max 图生图API 调用步骤与参数配置说明
2026 图生图接口怎么接入：千问-image-max 图生图API 调用步骤与参数配置说明
图生图接口看起来只是“多传一张参考图”，真正容易踩坑的地方是参数怎么配、返回怎么等、结果怎么复核。
下面按实际调用顺序说明 千问-image-max 图生图 API 的接入方式：先理解它与文生图的差别，再完成鉴权与参数配置，最后处理返回结果与批量调用前的核对。文中字段名与取值均为结构示意，正式调用请以官方文档与控制台展示的信息为准。
一、图生图接口和文生图接口差在哪里
文生图只有一个输入源：文字描述。图生图至少有两个：一张参考图加一段描述。参考图决定构图、主体轮廓和大致色调，提示词决定要改变什么、保留什么。所以图生图的实际效果，往往在提示词把“保留什么”写清楚之后才会稳定。
从接口角度看，图生图多出来的部分是参考图的传递方式：有的接口接受图片 URL，有的要求先上传再拿素材 ID，有的支持 base64 内联。传参方式不同，出错的位置也不同，接入前先确认接口期望哪一种，能省掉大量调试时间。
不同任务下的输入与输出对照
| 任务类型 | 输入 | 输出 | 复核点 |
|---|---|---|---|
| 局部换材质 | 原图 + 材质描述 | 保留构图的新图 | 边缘与光影是否自然 |
| 风格迁移 | 原图 + 风格描述 | 风格化结果 | 主体是否变形失真 |
| 商品图换背景 | 商品图 + 场景描述 | 新背景成品图 | 阴影方向与透视关系 |
| 线稿细化 | 线稿 + 细节描述 | 上色或细化图 | 原始线条是否被保留 |
二、千问-image-max 图生图 API 的调用步骤
第 1 步：确认鉴权方式与请求地址
图像类接口的鉴权与文本接口接近，大多也是在请求头里带 Bearer Token。要确认三个值：API Key、Base URL、模型名称。Base URL 由平台提供，拼接路径时先看清它是否已经包含版本号；模型名称必须来自控制台展示的字符串。
如果使用 通联AI中转站 这类统一入口，通常先注册账号并在控制台创建 API Key，再从模型广场复制模型名称与接口地址。平台上当前提供哪些图像模型、支持哪种传参方式，以页面实时展示为准。
第 2 步：参数怎么配
图生图的参数大体分成四类，具体字段名以文档为准：
- 输入类：参考图、正向提示词，以及可选的负向提示词。
- 输出类：输出尺寸、生成数量、输出格式。
- 控制类：改动幅度或相似度、随机种子。
- 业务类：水印开关、内容审核相关配置。
其中“改动幅度”最容易被误用。不同模型的参数方向和取值范围并不统一，有的数值越大越贴近原图，有的正好相反。必须按文档里的取值说明来调，不要凭经验把一个模型的参数习惯套到另一个模型上。
提示词的写法也值得单独说明：与其写“更好看、更高级”这类空泛描述，不如写清主体、材质、光线、背景和视角。同时明确哪些部分要保留，例如“保持商品原有配色与 Logo 位置不变”，能显著减少返工。
第 3 步：发起请求并解析返回
下面是一段请求结构示意，字段名仅用于说明组织方式。
POST {BASE_URL}/images/edits
Authorization: Bearer $API_KEY
Content-Type: application/json
{
"model": "<控制台展示的模型名称>",
"image": "<参考图 URL 或素材 ID>",
"prompt": "将背景替换为浅灰色影棚，保留商品原有配色",
"size": "<文档支持的尺寸>",
"n": 1,
"seed": 12345
}用固定随机种子做几轮对照实验，是调参最省时间的办法：保持其他参数不变，只改一项，观察输出差异。等效果稳定后，再把这组参数固化到业务代码里。
三、返回处理：同步返回与异步任务
图片接口的返回形态一般有两种：直接返回图片地址或 base64 数据，或者返回任务 ID 需要轮询。后者在批量调用时更常见，因为图片生成也可能排队。
轮询间隔不要设得太密。比起把频率提到极限，更实用的做法是设置阶梯式间隔，并在任务长时间未完成时给出明确的状态提示，而不是一直静默等待。
解析返回时，除了成功分支，还要把“内容审核未通过”“部分成功”这类状态单独处理，不要让它们落进通用的失败重试里，否则会反复提交同样会被拒绝的请求，既浪费额度也拖慢队列。
四、参数配置中最常见的 5 个问题
- 参考图不可访问：地址需要鉴权、已过期，或返回的不是图片内容，先用浏览器直接打开验证一次。
- 尺寸超出支持范围：不同模型对长宽比和像素上限的要求不同，按文档取值，必要时先等比缩放。
- 提示词信息量太低：只写风格词而不写主体和保留项，模型只能自由发挥，结果自然不稳定。
- 忽略审核返回：把审核失败当成普通报错反复重试，会持续产生无效请求。
- 没有固定种子：同一组参数每次结果都不同，导致无法判断是参数生效了还是随机波动。
五、批量调用前要核对的信息
图像接口的费用通常与调用张数、输出尺寸、单次生成数量相关，具体计费口径与单价请以平台计费页面的实时说明为准。批量跑之前建议先做一件小事：拿几十张真实素材跑一轮小规模试跑，统计单张平均耗时、失败率和返工比例，再据此确定并发数和预算。
调用量上来以后，余额、Key 和模型配置最好集中管理。通联官网 的控制台把 API Key、余额与模型选择放在同一处，适合长期跑图像任务的团队做日常核对，可用模型与计费规则以控制台页面显示为准。
如果你已经准备好参考图和提示词，下一步可以注册通联账号，在控制台获取 API Key、确认图像模型名称，并按本文步骤完成第一次图生图请求，再决定是否接入批量流程。