2026年GK-video-3.5 产品展示 API 接入教程：从参数配置到成片输出
2026年GK-video-3.5 产品展示 API 接入教程：从参数配置到成片输出
产品展示视频的痛点，很少是“做不出来”，而是“做不够快、不够多”。当每周要出几十条素材时，把生成流程接进自己的系统几乎是必然选择。
下面这份接入说明围绕 GK-video-3.5 产品展示 API 的落地路径展开：配置项怎么核对、任务怎么提交、成片怎么验收、出错先看哪里。文中不承诺任何固定的生成速度或画质结果，具体表现请以你所使用的服务端说明与实际测试为准。
为什么产品展示类视频适合走 API
网页端工具适合试效果，API 适合跑量。产品展示是典型的“模板化程度高、变量集中在素材和文案”的场景：画幅、时长、节奏、镜头语言基本稳定，变的是商品、卖点和价格文案。这种结构最适合用接口批量驱动。
走 API 之后，通常能得到三个实际好处：一是把生成动作嵌进已有的商品管理系统，上新即出片；二是参数可以做成配置项，让运营改字段而不是改代码；三是任务与结果可追踪，方便统一做失败重试和素材归档。
代价是你要多处理几件事：鉴权、任务状态、结果落库以及失败重试。这几件事做顺了，流程才算真正稳定。
接入前要固定的四个配置项
不管是自建调用还是通过聚合入口调用，先把下面这张表里的四项确认清楚，能省掉大部分“本地跑不通”的时间。
| 配置项 | 在流程里的作用 | 建议的核对方式 |
|---|---|---|
| API Key | 身份鉴权，决定请求能否被受理 | 在控制台生成后存入环境变量或密钥服务，不要写进前端代码和公开仓库 |
| Base URL | 请求实际发往的服务地址 | 直接复制控制台或文档给出的地址，注意结尾是否带 /v1 之类的路径前缀 |
| 模型名称 | 指定使用哪一个生成能力 | 大小写、连字符、版本后缀全部照抄，不要凭记忆拼写 |
| 结果获取方式 | 拿到成片链接或任务状态 | 有公网回调就配 webhook；没有就用轮询查询任务，并设置间隔与超时上限 |
模型名称是最容易出错的一项
视频生成类接口的模型名常带版本号或能力后缀，且大小写敏感。建议把模型名做成后端配置项，而不是硬编码在业务代码里，后续切换版本时改动量最小。另外要注意，网页端下拉框里显示的名称和接口里要求的名称不一定完全一致，以接口文档为准。
从参数配置到成片输出的三个步骤
第一步：把素材整理成结构化输入
产品展示视频的输入通常分三块，建议在业务侧先做一次校验，再送进接口：
- 商品主体素材：主图、多角度图或已有的短视频片段，尽量统一背景与光线，避免同一批素材风格差异过大
- 文案要点：卖点、规格、价格与行动引导语，价格类信息建议由后端注入，避免在多处硬编码
- 风格约束：画幅、时长区间、节奏、背景色与字幕风格，同一类目尽量保持一套规范
素材越规范，后面出片的一致性越好，人工返工也越少。这一步偷懒，后面就要用几倍的时间补回来。
第二步：提交任务并处理异步返回
视频生成基本是异步的：提交后先拿到任务标识，再通过回调或轮询取结果。请求体大致如下，字段名和取值请以官方文档为准：
{
"model": "GK-video-3.5",
"prompt": "产品展示：户外保温杯缓慢旋转，纯白背景，柔和侧光",
"duration": 8,
"aspect_ratio": "9:16",
"callback_url": "https://your-domain.com/hook/video"
}提交时至少要做三件事：记录任务标识与完整请求参数、校验返回体中是否包含任务号、给轮询设置上限次数和退出条件。没有上限的轮询在批量场景下很容易把服务打满，也会掩盖真正的失败原因。
第三步：成片验收与人工复核
接口返回“任务完成”不等于“素材可用”。建议在流程里加两层检查：自动层检查时长、分辨率、文件能否正常解码；人工层检查商品外观、字幕文案、价格信息是否正确。后者目前无法被完全自动化替代。
不要把生成结果直接推到投放渠道。视频类生成的典型问题不是报错，而是“能播但信息错了”——标签变形、字幕错字、价格文案过期，这类问题只能靠人工确认拦住。
常见报错先看这四处
按出现频率从高到低，通常依次是：鉴权失败、模型名不匹配、参数超出取值范围、任务超时。前两类看一眼错误信息基本就能定位；后两类需要把提交参数和原始素材放在一起看。如果同一个请求在网页端可跑通、在自己代码里失败，优先怀疑请求头、内容类型以及路径拼接方式。
把视频能力和其它模型放在一个入口管理
产品展示视频很少是单一模型的活：前面可能要生成商品文案，中间要处理图片，后面还要配音。如果每项能力都单独对接一家服务商，Key、余额和账单会迅速碎片化，排查问题时也难以判断是网络、鉴权还是模型侧的问题。
这也是不少团队会先拿 通联AI中转站 跑一遍流程的原因：它把多种模型能力收在同一个控制台下，提供 OpenAI 兼容方向的统一接入方式，API Key、Base URL 与模型选择集中在同一处管理，切换模型时多数情况下改配置即可，不必重写整套调用逻辑。
动手写 GK-video-3.5 产品展示 API 的调用代码之前，建议先到 通联官网 核对三件事：控制台当前展示的模型名称、文档给出的接口地址、以及该能力对应的计费与额度说明。这三项确认完再开始写代码，返工概率会低很多。
如果你准备把产品展示视频的生成流程接进自己的系统，可以先注册账号，拿到 API Key 与接口地址，用一条最小请求跑通链路，再逐步扩展到批量任务。