首尾帧视频生成并不难，难的是把首帧图、尾帧图、提示词、时长和分辨率一次对齐。

不少人在本地跑通了示例，换到线上环境却卡在图片格式、字段命名或任务轮询上。这篇指南按“准备—调用—排错”的顺序，把万相3.0 首尾帧 API中转接入的关键环节拆开讲清楚：先说明首尾帧到底在控制什么，再给出可执行的请求组织思路，最后把高频报错逐条对应到排查动作。你可以对着自己的请求日志逐项核对。

一、先弄明白：首尾帧视频生成在控制什么

文生视频只给一段文字描述，运动轨迹由模型自行发挥；首尾帧生成则额外给了两个锚点：起点画面和终点画面。模型要做的事，变成在这两个锚点之间补出一条合理的运动路径。这个差别直接决定了提示词的写法和参数的选择。

首帧、尾帧与提示词各自负责什么

• 首帧图：确定画面的起点、构图、主体位置与整体色调。它决定了视频“从哪儿开始”。
• 尾帧图：确定画面的落点。它决定了视频“结束在什么状态”，也间接约束了运动幅度。
• 提示词：描述中间过程，例如镜头运动方式、主体动作、光线变化、氛围走向。中间过程描述得越具体，成片越接近预期。
• 时长与分辨率：时长决定运动的从容程度，分辨率决定细节与生成耗时。两者都会显著影响成本与等待时间。

首尾帧生成的效果上限，往往不是模型决定的，而是你提供的两张图能不能“接得上”。两张图的主体位置、景别差异过大时，模型只能硬补，中间段就容易出现跳变或形变。

二、接入前需要确认的五项信息

无论你是直连官方接口，还是通过 API 中转的方式调用，都需要先把下面几项确认清楚。它们决定了你的请求能不能发出去、发出去之后能不能被正确解析。

如果你同时要接多个模型厂商，逐个平台维护 Key、额度和地址会比较琐碎。这时候可以考虑使用聚合型入口，例如 通联AI中转站：它的思路是用一个 Base URL 统一承接多种兼容协议，在控制台里集中管理 API Key、余额和模型选择，具体支持范围与模型名称仍以控制台页面显示为准。

三、万相3.0 首尾帧 API 中转的调用思路

接入流程本身不复杂，关键是顺序不要乱。建议按下面的四步推进，每一步确认无误再往下走，避免把参数问题和网络问题混在一起排查。

步骤一：确定协议与鉴权方式

先确认你使用的接口遵循哪种协议。如果是 OpenAI 兼容方向，通常沿用常见的 Authorization: Bearer <API Key> 请求头；如果平台提供独立的原生协议，则按文档给出的鉴权字段填写。这一步做错的典型表现是返回 401 或 403。

步骤二：准备两张可被访问的图片

首帧和尾帧需要模型能够读取。使用公网 URL 时，确认链接无需登录即可访问，且不是短期有效的临时签名地址；使用 Base64 时，注意请求体体积会明显增大，需要留出超时余量。两张图建议保持相近的宽高比，主体位置尽量连贯。

步骤三：组装请求体

请求体的核心是把模型名称、提示词、首帧、尾帧、时长等字段放在正确的位置。下面是一个结构示意，字段名仅用于说明组织方式，实际字段请以官方文档或控制台示例为准：

{ "model": "从控制台复制的模型名称", "prompt": "镜头缓慢推近，人物转身望向窗外，光线由暖转冷", "first_frame_image": "https://your-cdn.example/first.jpg", "last_frame_image": "https://your-cdn.example/last.jpg", "duration": 5, "resolution": "按文档支持的档位填写" }

步骤四：处理异步结果

1. 发起生成请求，记录返回的任务标识或请求 ID。
2. 按文档建议的间隔轮询任务状态，不要用高频死循环。
3. 状态变为成功后再下载视频文件，并保存到自己的存储中，避免依赖临时链接长期可用。
4. 把原始请求参数与任务 ID 一并落库，便于后续复现与问题反馈。

四、排错要点：高频问题怎么定位

排错的核心原则是“先分层，再定位”。先判断问题出在网络层、鉴权层、参数层还是任务层，再针对性地看日志，效率会高很多。

五、几个容易被忽略的细节

• 不要写死模型名称。模型迭代后名称可能调整，建议配置化读取，改动时不用重新发版。
• 给超时留足余量。视频生成属于耗时任务，客户端超时设置过短会把正常等待误判为失败。
• 记录成本相关字段。把每次任务的时长、分辨率、返回的用量信息一起存下来，便于后续估算投入。
• 保留重试能力但要克制。对幂等性不明确的任务，盲目重试可能产生重复消耗。

六、小结与下一步

总结一下：万相3.0 首尾帧 API中转接入的难点不在代码量，而在细节对齐——接口地址与模型名称必须与平台展示一致，首尾帧图片必须“接得上”，异步任务必须按状态字段正确判断。把这三点做扎实，大部分报错都会变得可定位。

如果你希望少花时间在多家平台的 Key、余额和地址之间来回切换，可以到 通联AI中转站官网 注册一个账号，在模型广场里确认可用的模型条目和对应文档，再按本文的四步流程做一次最小请求测试。具体模型、计费与接入说明以控制台实时展示为准。