2026 年万相3.0 首尾帧 国内API接入教程：鉴权、参数与生成流程

2026 年万相3.0 首尾帧 国内API接入教程：鉴权、参数与生成流程

首尾帧生成视频，听起来只差两张图。真正动手后，卡住人的往往不是创意，而是鉴权方式、字段名和异步任务的取结果逻辑。

这篇教程按“准备—鉴权—参数—生成—排查”的顺序，把万相3.0 首尾帧 国内API接入 的完整链路拆成可以逐项核对的步骤。文中出现的字段名与请求示例只用于说明结构，实际请求请以控制台和接口文档给出的模型名称、参数名为准，不同版本之间可能存在差异。

一、接入前先固定四项配置

国内接入视频生成类接口，最常见的坑是照着别人的示例改代码，结果模型名、参数或者地址对不上。动手之前，建议先把四项配置固定下来。

• API Key：用于身份鉴权，一般放在请求头中。不要写进前端页面或公开仓库。
• Base URL：接口根地址，决定请求发往哪里。
• 模型名称：控制台中实际可调用的模型标识，大小写和连字符都要一致。
• 调用方式：视频生成多为异步任务，提交后需要轮询任务状态或等待回调。

配置项速查表

二、鉴权：请求发出前的最后一道检查

API Key 应该怎么放

兼容 OpenAI 风格的接口，鉴权头通常按下面的结构组织：

POST https://你的接口地址/v1/video/generations
Authorization: Bearer 你的APIKey
Content-Type: application/json

如果返回 401，先别怀疑模型。按顺序确认三件事：请求头名称是否写对、Key 是否夹带了多余空格或换行、这个 Key 是否已经被删除或轮换。

Base URL 与兼容协议别混用

视频类模型的协议并不完全统一，有的走 OpenAI 兼容风格，有的需要按厂商原生结构组织请求体。团队如果同时要调多个模型，通常会把地址和 Key 统一到一处管理。通联AI中转站的方式是用一个 Base URL 承接多种兼容协议的模型调用，减少在多个控制台之间反复切换配置的成本。迁移时更稳妥的顺序是：先核对控制台给出的 Base URL、模型名称与兼容协议，再逐步替换项目里的配置，而不是一次性全量切换。

三、首尾帧参数怎么组织

首尾帧生成的核心逻辑是“给定起点和终点，让模型补出中间过程”。因此请求体里最关键的两类信息是画面和节奏。

画面：首帧与尾帧

首帧通常是必填，尾帧在多数实现中可选。填写方式常见三种：可公网访问的图片 URL、Base64 编码、或者已上传素材的 ID。三种方式的字段名与长度限制不同。如果接口提示参数错误，第一件事就是确认你传的是哪一种，而不是直接改字段名。

节奏：时长、分辨率与画面比例

时长、分辨率和画面比例会直接影响生成耗时与消耗。同一组首尾帧，时长翻倍，处理时间和用量通常也会上升。建议先用最短时长和较低分辨率跑通链路，确认能稳定拿到结果，再逐步提升画质。

首尾帧视频的调参顺序建议是：先保证接口能返回任务 ID，再保证能取到结果，最后才去优化画面质量。顺序反过来，排查成本会成倍增加。

四、生成流程：从提交到取回结果

1. 准备两张构图接近、主体一致的图片，避免差异过大导致过渡不自然。
2. 按文档构造请求体，先用首帧提交一次最小请求，确认鉴权与地址正确。
3. 保存返回的任务 ID 或 request_id，记录完整返回结构，方便后续轮询。
4. 按合理间隔轮询任务状态，既不要高频空转，也不要间隔过长导致无法判断任务是否卡住。
5. 任务成功后再下载或转存结果，同时记录本次参数，便于复现和对比。

如果流程中某一步拿不到明确返回，先保留完整的请求体和响应体，再去比对文档，比反复改代码更有效。

五、常见问题与下一步

高频问题集中在三处：鉴权头写错、模型名称与文档不一致、以及把异步接口当同步接口等待。前两个靠比对配置就能解决，第三个需要检查请求路径是否指向了任务查询接口而不是提交接口。

如果需要同时测试多个视频或图像模型，逐个申请 Key、逐个改地址会比较耗时。通联官网提供了模型查看与统一调用的入口，可以先在控制台确认当前可用的模型和参数说明，再决定用哪条链路接入。

链路跑通之后，下一步就是把鉴权方式、模型名称和 Base URL 固定到自己的项目里。可以到通联注册账号，进入控制台查看当前可用的模型与接口说明，获取 API Key 后按本文步骤做一次首尾帧最小请求。

注册后获取 API Key 开始接入