2026年万相-视频换人 产品展示 API 接入教程：参数配置与视频生成流程

做产品展示视频时，真正卡住人的往往不是“模型能不能换人”，而是参数怎么填、素材怎么给、结果怎么验。

万相-视频换人 产品展示 API 属于典型的异步生成类接口：提交一段原始视频和一张人物素材，服务在后台完成处理后返回结果地址。也就是说，接入的重点不只是请求能不能发出去，还包括素材规范、参数约束、轮询节奏和结果复核。下面按实际接入顺序讲一遍。

先弄清楚这条链路在做什么

万相-视频换人 产品展示 API 解决的是“保留原视频的画面运动、构图与节奏，把其中的人物替换成指定形象”这类需求，常见于商品展示、口播替换、服装上样等内容场景。和纯文生视频相比，它的输入更重：原视频的时长、分辨率、运动幅度、遮挡情况都会直接影响结果可用性，人物素材的清晰度、角度与光线也会影响替换后的自然程度。

所以在写代码之前先确认三件事：输入是文件上传还是 URL 引用；结果是同步返回还是异步任务查询；有没有时长、分辨率或帧率上限。这三项里任何一项不同，代码结构就要跟着改。

接入前的准备

密钥、接口地址与文档

第一步永远是拿到可用的 API Key 与正确的 Base URL。不同平台的鉴权头写法、参数命名和返回结构可能不一致，不要凭经验照抄另一个项目的配置。如果手上有多条视频类模型需要对比，可以到 通联AI中转站 的模型广场查看当前可用模型、协议方向与接入文档，再从控制台创建密钥。某个具体模型是否可用、以什么参数暴露、支持哪些输入形式，以控制台和文档页的实时信息为准。

素材与授权

视频换人涉及真人形象，务必先确认素材使用权与肖像授权，不要在未获授权的情况下替换他人形象用于商业宣传。这一步不是流程负担，而是避免后续下架与纠纷的必要成本。

参数配置：按类目理解，而不是背字段名

各平台的参数命名并不统一，但大类目相对固定。下表按常见命名习惯整理，具体字段名、是否必填与取值范围，请以你所调用接口的官方文档为准。

视频生成流程：从提交到取回结果

1. 整理素材：把原视频裁到目标时长，确认人物素材清晰、角度正面、无重遮挡，并完成授权确认。
2. 构造请求：填写模型标识、视频与人物素材地址、时长与分辨率等必要参数，第一次只用必填项。
3. 提交任务：保存返回的任务标识，它是后续查询结果的唯一凭据，务必落到日志里。
4. 等待结果：按文档说明轮询或接收回调，轮询间隔不要过密，并设置合理的整体超时时间。
5. 下载并复核：检查人物一致性、边缘融合、口型与画面闪烁，人工过一遍再进入发布流程。
6. 记录参数：把这次可用的参数组合存档，之后批量生成时直接复用，不必每次重新试。

批量调用之前，先用一条几秒的短片把参数跑通。视频类任务的失败代价通常是“等了几分钟才报错”，用最短素材验证能省下大量无效等待。

常见问题与排查思路

提交成功但长时间处于处理中

先确认素材地址是否能被服务端正常拉取，部分失败其实是取素材超时；再确认时长与分辨率是否超出限制。有些接口不会在提交阶段直接拒绝，而是进入处理后才失败，所以超限问题需要结合文档逐项对照。

结果跳变、闪烁或边缘不自然

多数情况与素材相关：原视频存在严重遮挡、快速大幅度运动，或人物素材的光线与视频不匹配。可以换一段运动平缓的片段做对照测试，先判断是素材问题还是参数问题。

返回参数校验错误

逐一核对模型标识是否原样复制、必填字段是否缺失、地址格式是否符合要求。如果同一个请求昨天能跑通、今天报错，优先检查密钥状态与接口是否有版本变化，相关说明可在 通联官网 的文档与页面信息中核对。

产品展示场景的三条实用建议

• 把“样片验证”和“批量生成”拆成两个阶段，不要直接对全量素材发起任务。
• 为每批任务记录素材版本与参数组合，出问题时才能回溯是哪次改动导致的。
• 生成结果只作为素材使用，发布前仍需人工确认画面、文案与合规性。