把图生视频接进业务后，最先卡住人的往往不是模型效果，而是首尾帧怎么传、时长怎么设。参数错一位，画面就可能变成突兀跳切。

这篇指南围绕 万相 2.7 视频续写 图生视频 API 的接入流程展开，重点讲清楚三件事：首帧与尾帧各自的职责、时长参数与画面节奏的关系、以及联调阶段该按什么顺序排查问题。文中涉及的字段名、模型名称与计费规则，请始终以你所使用平台的控制台和接口文档为准，不同平台的命名差异很常见。

一、先分清三个概念：图生视频、视频续写、首尾帧控制

很多接入问题的根源，是需求方和开发方对同一句话的理解不一致。把概念对齐，后面的参数配置会顺很多。

• 图生视频：以一张静态图作为起点画面，生成一段具有运动和镜头变化的视频。输入是图加提示词，输出是视频片段。
• 视频续写：在已经存在的片段之后接着生成，要求主体动作、镜头方向、色调风格尽量延续，而不是重新起一个画面。
• 首尾帧控制：同时给出起点图和终点图，让模型在两张图之间生成过渡过程。它的价值在于结果可控——你告诉模型从哪里出发、要落在哪里。

三者经常组合使用。例如做分镜预演时，用首尾帧生成单个镜头；做长视频时，把上一段的最后一帧作为下一段的首帧，实现连续续写。

二、接入前的准备清单

在写第一行代码之前，建议先把下面这张表里的信息确认清楚。这一步花十分钟，能省掉后面几小时的无效调试。

如果你希望减少在多个平台之间来回切换控制台、分别维护 Key 和余额，可以借助聚合类平台把接入入口统一起来。例如在 通联AI中转站 的控制台里，可以集中查看模型广场、文档说明与 API Key 管理入口，用一个 Base URL 对接多种兼容协议，具体的模型名称与可用能力仍以页面实时展示为准。

三、首尾帧与时长：三个关键参数的配置思路

1. 首帧决定构图，不要用模糊图

首帧通常决定主体在画面中的位置、景别和光线基调。如果首帧里人物在画面左侧三分之一处，生成结果大概率会延续这个构图。因此建议首帧使用清晰、主体完整、背景不杂乱的图片，分辨率不要低于生成规格，否则模型可能自行补出细节，导致与品牌素材不一致。

2. 尾帧决定落点，不给尾帧等于放任模型自由发挥

只给首帧时，模型会按照提示词自行想象运动方向，结果往往是"能看但不可控"。加上尾帧后，中间过程被约束在两张图之间，适合需要精确落到某个画面的场景，比如产品从全景推到特写、人物从站立到回头。需要留意的是，首尾帧差异过大时，中间过程可能出现形变或闪烁，建议两帧之间的构图差异控制在合理范围内。

3. 时长要配合镜头节奏，而不是越长越好

时长参数直接决定片段覆盖的动作数量。一段 3 到 5 秒的画面通常只够完成一个完整动作，例如一次转身、一次推镜；如果强行拉长到十几秒，中间就容易出现停顿或重复动作。实际操作中，比较稳妥的做法是：先按最短可用档位生成，确认画面连贯后再加长，或者拆成多个短片段，用上一段的尾帧作为下一段的首帧做续写。

另外需要注意，时长、帧率与分辨率往往共同影响生成耗时和消耗，三者并非独立调节。批量生产时建议固定其中两项，只调整一项做对比测试。

四、一次完整调用的流程

1. 在控制台创建或复制一枚 API Key，并确认它绑定的权限范围。
2. 核对 Base URL 与兼容协议，确认与你当前的 SDK 调用方式匹配。
3. 上传首帧图片，拿到可公开访问的图片地址。
4. 如需精确控制落点，再上传尾帧图片。
5. 编写提示词，描述动作、镜头运动与氛围，不要只写"生成视频"。
6. 设置时长与分辨率，从最小档位开始测试。
7. 发起请求，按文档说明轮询任务状态或接收回调。
8. 拿到结果后先人工复核，再进入批量流程。

{ "model": "以控制台展示的模型名称为准", "prompt": "镜头缓慢推进，人物回头微笑，光线保持柔和", "first_frame_image": "https://your-cdn/first.jpg", "last_frame_image": "https://your-cdn/last.jpg", "duration": 5, "resolution": "720p" }

字段命名各平台不完全一致，上面的结构只用于说明思路。真正接入时，请以控制台文档给出的参数名称为准，避免因为一个下划线写错而反复排查。

五、联调阶段的常见问题

报错时不要先怀疑模型能力。绝大多数失败集中在三类：鉴权信息不对、图片地址不可访问、参数超出允许范围。按这个顺序排查，通常几分钟就能定位。

• 返回鉴权失败：检查 Key 是否复制完整、是否带了多余空格、是否误用了旧环境的 Key。
• 提示图片无法读取：确认图片地址是公网可直接访问的，且返回的是图片内容而不是登录页 HTML。
• 任务长时间无结果：视频生成通常属于异步任务，需要轮询或回调，不要用同步请求的超时标准去判断。
• 画面跳变明显：优先检查首尾帧构图差异、提示词是否与画面冲突、时长是否超出该片段能承载的动作量。

六、成本与批量生产的注意点

视频生成类接口的成本，通常与时长、分辨率、生成次数直接相关，部分平台还会区分任务提交与实际产出。因此在正式批量跑之前，建议先用小批量验证：先确认单条成本的可接受范围，再放大规模。

需要重点管理的是三件事：余额（避免任务中途因额度不足中断）、用量（按项目或团队拆分 Key，便于归因）、计费规则（是否按秒、按次、按时长档位）。这些信息在 通联AI中转站 的官网页面上有对应的说明入口，实时价格与可用模型建议直接以页面展示为准，不建议依据第三方文章中的历史数字做预算。

最后提醒一点：无论接入方式多顺手，视频生成的结果都需要人工复核。时长、构图、动作连贯性这些维度，目前仍然依赖人的判断，把它当作提效工具而不是完全替代人工的环节，项目推进会稳得多。