2026年 万相3.0 参考生 广告视频 API 接入指南：参考图生成广告视频的调用步骤与参数说明
2026年 万相3.0 参考生 广告视频 API 接入指南：参考图生成广告视频的调用步骤与参数说明
用一张产品参考图生成广告视频，听起来只是“上传图片、点击生成”。真正接入 API 时，卡点往往在参考图的规范、参数的取值方向，以及异步任务怎么取回结果。
参考图生视频属于多模态生成任务：模型读取参考图中的主体、构图与风格信息，再结合文字提示生成动态画面。它和纯文生视频的区别在于，画面主体不是完全“凭空生成”，而是以你提供的图片为锚点，因此更适合商品展示、品牌素材延展这类对画面可控性要求较高的广告内容。
一、这类接口适合解决什么问题
广告视频的生产链条通常包含创意、拍摄、剪辑、投放几个环节，其中最容易产生重复劳动的是“同一主视觉要多版本、多尺寸、多语言”。参考图生视频的价值就集中在这一段：把已经定稿的静态素材转成动态版本，减少重新拍摄的沟通成本。
适合的场景
- 电商主图、产品图的动态化：把静态商品图变成几秒钟的展示视频。
- 信息流素材批量延展：同一张主视觉，配不同文案与节奏，产出多版本素材用于测试。
- 区域化广告版本：替换文案语言或配色，保持主体画面一致，降低跨市场制作的重复投入。
- 创意提案阶段：在正式拍摄前快速验证镜头走向和画面节奏是否成立。
需要人工复核的边界
生成的画面里，文字、logo、人脸、包装细节都可能在运动过程中出现轻微形变，光影与材质有时也不完全稳定。广告素材对准确性要求高，所以参考图生视频更适合作为创意初稿和素材池补充，最终投放前仍然需要人工逐条检查。涉及真人肖像、商标、版权的素材，还要确认授权范围后再使用。
二、调用前要准备的三类东西
1. 参考图素材
参考图是整个任务的基础。建议使用主体清晰、背景不过度杂乱、无明显水印的图片，分辨率要满足文档中的最低要求，同时注意文件体积上限。如果原图过大，先本地压缩再上传，比让接口处理更省时间。多张参考图是否支持、各自权重如何分配，需要查看具体文档说明。
2. 鉴权凭据与接口地址
调用前需要在控制台创建 API Key，并确认接口地址与模型标识。以 通联AI中转站 为例，用户可以在控制台统一管理 API Key、余额与调用配置，在模型广场中核对当前可用的视频生成类模型及其调用方式。实际可用的模型名称、接口路径与计费规则，请以控制台和文档页面实时展示的信息为准。
3. 提示词与目标规格
先想清楚成片的用途：投放在哪个平台、是横版还是竖版、需要几秒。规格确定之后再写提示词，比先写提示词再改规格效率更高。
三、参数说明：每个字段在控制什么
不同平台的字段名可能不同，但控制的维度大体相近。下面按“参数方向”整理，方便你把手中的文档字段对号入座。
| 参数方向 | 作用 | 取值思路 | 注意点 |
|---|---|---|---|
| 参考图 / 首帧图 | 决定主体、构图与画面基调 | 主体清晰、无水印、分辨率达标 | 确认格式与体积上限，必要时先压缩 |
| 提示词 | 描述镜头运动、节奏与氛围 | 重点写“怎么动”，少重复“有什么” | 与参考图内容冲突的描述会干扰结果 |
| 时长 | 决定成片秒数与消耗量 | 按投放位要求选，先短后长 | 时长越长，单位成本与形变风险越高 |
| 比例与分辨率 | 决定成片适配的平台版位 | 竖版适配短视频，横版适配信息流 | 需落在文档允许的取值范围内 |
| 镜头运动强度 | 控制推拉摇移的幅度 | 广告类素材宜克制，保持主体稳定 | 强度过高容易让产品产生畸变 |
| 随机种子 | 用于复现或微调同一版本 | 把表现好的种子值记录下来 | 更换参考图后未必保持同样效果 |
| 任务标识与回调 | 用于异步取回生成结果 | 按服务架构选择轮询或回调 | 回调地址需公网可访问且可幂等处理 |
四、调用步骤：从提交任务到拿到成片
第一步：提交生成任务
视频生成通常耗时较长，多采用“提交任务、稍后取结果”的异步模式。请求体结构大致如下，字段名仅作结构示意，实际名称以文档为准。
POST /video/generations
{
"model": "控制台显示的模型标识",
"image": "参考图的公网可访问地址",
"prompt": "镜头缓慢推进，产品居中，光线柔和",
"duration": 5,
"ratio": "16:9"
}提交后保存返回的任务标识，后续所有查询都依赖它。如果参考图是从本地读取，需要先上传到可访问的存储并生成链接，不要直接传本地路径。
第二步：轮询状态或接收回调
轮询适合脚本和小规模任务，按固定间隔查询，连续失败要设置上限避免死循环；回调适合有服务端的生产环境，能减少无效请求，但要处理重复推送。无论哪种方式，都要把任务状态分成“排队、处理中、成功、失败”四类分别处理，失败时记录错误信息而不是简单重试。
第三步：下载、命名与版本归档
结果链接通常有有效期，建议生成后立即下载到自己的存储，并按“素材来源 + 版本号 + 日期”的规则命名。同一参考图往往会有多个版本，命名规范能避免后续投放时拿错素材。
五、成片复核清单
自动生成的视频不建议直接投放。下面的检查项可以当成固定流程执行。
- 主体一致性：产品形态、颜色、包装文字是否与参考图一致。
- 画面连续性：有无跳帧、闪烁、主体突然变形。
- 文字准确性：画面中出现的文字是否清晰、有无错字。
- 规格匹配：比例、时长、分辨率是否满足投放平台要求。
- 合规检查：肖像、商标、版权素材的使用是否有依据。
把复核做成清单而不是凭感觉判断，能显著降低返工率。尤其是批量生成时，逐条比对比整体观感更可靠。
六、成本与用量怎么控制
视频类任务通常按生成时长或次数计费，成本随批量线性上升，因此控制成本的重点在于减少无效生成，而不是压缩必要的复核环节。比较实用的做法是先固定参考图与提示词，用最短时长跑一批小样本，确认风格方向之后再放大批量。把表现稳定的参考图、提示词和种子值保存下来，后续复用可以减少试错次数。具体的计费方式、余额消耗与充值入口，请以 通联AI中转站 官网页面实时展示的信息为准，不同模型的计费口径可能不同。
如果团队同时使用图像、视频、语音等多类能力，可以考虑在统一入口下管理调用配置和用量，减少在多个平台之间来回切换的维护成本。开始之前建议先确认三件事：模型是否已上架、接口地址与模型标识是否匹配、计费口径是否在预算范围内。
参考图、提示词和时长参数都确定之后，就可以跑第一条测试任务了。注册通联账号后，可以在控制台查看视频生成类模型的可用状态、接口地址与计费说明，先小批量试跑，再决定是否用于正式的广告物料生产。