2026年 SD 2.5 满血版 按秒 图生视频API 接入指南：请求参数与调用示例
2026年 SD 2.5 满血版 按秒 图生视频API 接入指南：请求参数与调用示例
图生视频接口真正让人卡住的，往往不是“能不能调通”，而是参数怎么填、任务怎么轮询、按秒计费怎么核算。把这三件事理顺，接入就只是一次配置工作。
本文围绕 SD 2.5 满血版图生视频 API 的接入流程展开，，重点讲清楚请求参数、调用顺序、示例代码和常见报错的排查思路，尽量让第一次接触视频生成的人少走弯路。
先说一个前提：同一类模型在不同平台上暴露的字段名、返回结构和计费口径可能略有差异。下面给出的请求结构属于通用思路，实际调用时请以你所使用控制台显示的模型名称、接口地址与文档说明为准。
一、按秒计费的图生视频接口，和普通绘图接口差在哪
文本生成图片通常是同步的：一次请求，几秒内就能拿到结果。图生视频不一样，它需要根据首帧图像和提示词推演大量帧画面，计算量高得多，所以主流做法是异步任务制——先提交任务、拿到一个任务 ID，再按固定间隔查询状态，直到任务完成并返回视频地址。
“按秒计费”指的是按最终产出视频的时长计价，而不是按你等待的秒数计价。这意味着在同一个模型下，5 秒片段和 10 秒片段的成本差别，通常比换一句提示词带来的差别更直接。新手最容易忽略的一点是：参数里写了 5 秒，并不代表一定精确输出 5 秒，部分模型会根据实际推演帧数返回略长或略短的片段，所以最终计费口径要以平台账单或用量页显示的数字为准。
理解这一点之后，调试策略就清楚了：先用最短时长、较低分辨率把链路跑通，确认请求参数、鉴权、轮询逻辑都没问题，再逐步提高画质和时长。
二、接入前要准备的东西
- API Key：调用凭证。创建后通常只完整显示一次，请立刻保存到环境变量或密钥管理服务里，不要写进会提交到代码仓库的配置文件。
- Base URL：请求入口地址。它决定请求发往哪里，复制时不要手动补斜杠，也不要漏掉路径前缀。
- 模型名称：从平台的模型列表里复制，不要凭记忆手写。名称里的版本后缀、大小写差异都可能导致接口返回找不到模型。
- 可访问的输入图片：图生视频需要一张首帧图。用公网可直接打开的图片链接最省事；如果使用 base64，要注意请求体大小限制。
- 一个轮询脚本：任务提交后需要循环查询状态，建议先写一个独立函数，再接入正式业务逻辑。
| 配置项 | 作用 | 检查方法 |
|---|---|---|
| Base URL | 决定请求发往哪个接口入口 | 与文档逐字符对照，注意协议、域名与路径前缀 |
| API Key | 请求身份凭证 | 放在请求头中，确认前后没有空格或换行 |
| 模型名称 | 指定使用的视频模型 | 从模型列表复制，不要手写版本号 |
| 输入图片地址 | 作为视频首帧参考 | 先用浏览器直接打开，确认无需登录即可访问 |
如果你希望先用一个统一入口对比不同视频模型的调用差异，可以到 通联AI中转站 查看模型广场与接入文档，确认 Base URL、模型名称和兼容协议之后再写代码。通联把多家厂商的模型聚合在同一套接口体系下，对需要同时测试多组参数的团队来说，可以减少重复配置的工作量。
三、请求参数怎么拆
3.1 图片与提示词
绝大多数图生视频接口都围绕两组输入：一张图，一段文字。图片决定起点，提示词决定运动方向。写“镜头缓慢推进，水面泛起细微波纹”这类具体描述，比写“让这张图动起来”更容易得到可用结果。如果接口支持负向提示词，可以把画面变形、闪烁、卡通化等不想要的特征写进去。
3.2 时长、分辨率与帧率
这三个参数直接决定成本与等待时间。时长越长、分辨率越高，生成耗时和按秒计费的总量都会上升。第一次调试建议把时长压到最短，确认链路通畅后再提高画质。下面的请求体是通用结构，字段名请以文档为准：
{
"model": "你的视频模型名称",
"image": "https://example.com/first-frame.jpg",
"prompt": "镜头缓慢推进，水面泛起细微波纹",
"negative_prompt": "画面变形, 闪烁, 卡通化",
"duration": 5,
"resolution": "720p",
"fps": 24
}四、第一个调用示例
4.1 提交任务
curl -X POST "你的BaseURL/视频任务路径" \
-H "Authorization: Bearer $VIDEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"你的模型名称","image":"图片链接","prompt":"镜头缓慢推进","duration":5}'请求成功后，返回内容里通常包含一个任务标识。把它记下来，下一步轮询要用到。
4.2 轮询任务结果
curl -X GET "你的BaseURL/任务查询路径/任务ID" \
-H "Authorization: Bearer $VIDEO_API_KEY"轮询建议设置间隔，比如每 3 到 5 秒查一次，并设置最大重试次数或超时时间，避免脚本无限循环。状态字段的含义以文档为准，一般会出现排队中、处理中、已完成、失败几种取值。
五、常见报错与排查顺序
遇到报错时，按“鉴权 → 地址 → 参数 → 素材”的顺序排查，比东改一处西改一处更快定位问题。
接入阶段最常见的三类问题：一是密钥复制时带上了空格或被换行截断，导致鉴权失败；二是 Base URL 多写或少写路径前缀，请求打到了不存在的地址；三是输入图片链接需要登录才能访问，模型侧拉不到素材。这三类问题都不需要改代码逻辑，先核对配置就能解决。
如果返回的是并发或额度相关提示，先确认账户余额与当前并发限制，再考虑是不是同时在跑多个测试任务。把轮询频率调低一些，也能减少不必要的请求量。
六、把首次调用变成可复用的检查流程
一次成功调用不代表接入完成。建议把下面几件事固化成流程：把 Base URL、API Key、模型名称收进环境变量；把提交与轮询封装成两个函数；在日志里记录任务 ID、耗时与最终产出时长，方便后续核对用量；对不同时长参数各跑一遍，观察成本变化。
当你要测试的模型变多时，多平台分别注册、分别配置密钥会明显拖慢节奏。这时可以回到 通联官网 看看它提供的统一接入方式：一个 Base URL 对应多个模型，密钥与余额在同一个控制台管理，适合需要横向比较多套参数、又不想维护多套配置的场景。具体的模型名称、接口路径与计费规则，仍以控制台实时展示的信息为准。
图生视频的接入本质上是一次配置加一次异步流程设计。把参数含义、轮询逻辑和成本口径想清楚，剩下的就是重复验证与微调。
接口跑通之后，下一步是把模型名称、Base URL 与计费口径固定下来，再接入正式业务。你可以先注册账号、创建 API Key，按文档完整走一遍提交与轮询流程。