功能与支持范围
模板特效用于按照指定效果生成视频,素材数量和扩展字段取决于具体模板。腾讯云原生 CreateAigcVideoTask 的场景参数对 Vidu 列出 template_effect;Kling 列出动作控制、数字人和对口型。它们不是同一种模板能力。
本站本目录暂不提供已确认可用的腾讯云特效入口。 原 POST /tencent-vod/v1/template-effect 不能继续作为本站调用地址。腾讯云通用创建参数并未给出完整模板清单、每个模板的版本限制或 ExtInfo 内部结构,因此不要默认使用 morphlab,也不要假定任意 Vidu q3 型号都能使用此场景。
场景相关参数
字段位于腾讯云原生 JSON 请求体,其他必填字段、签名和返回值与创建接口参考共用。
| 字段 | 类型·要求 | 含义、默认与限制 |
|---|---|---|
ModelName | String;必填 | 模型系列,允许值见模型表;不是本站 /v1/models 中的完整模型 ID。 |
ModelVersion | String;必填 | 该系列对应的版本,允许值见模型表;版本必须与动作和素材组合匹配。 |
FileInfos[] | Array of AigcVideoTaskInputFileInfo;可选,条件见说明 | JSON 中写作 FileInfos 数组。首帧 Usage=FirstFrame、末帧 Usage=LastFrame,各最多一张;允许只有首帧,不允许只有末帧。参考素材使用 Reference。首尾帧参考图片比例;参考模式可调比例。一般图片不超过 10M,jpeg/jpg/png。不是每个版本都支持所有输入方式。 |
Prompt | String;可选,条件见说明 | 视频内容、动作与镜头提示词。文生视频请显式填写非空文本;不要依赖省略 Prompt 的条件分支。官方未声明统一长度上限。 |
SceneType | String;可选,条件见说明 | Kling:motion_control(动作控制)、avatar_i2v(数字人)、lip_sync(对口型);Vidu:template_effect(特效模板)。其他 ModelName 暂不支持。须同时符合具体型号的场景限制。 |
ExtInfo | String;可选,条件见说明 | 模型专用扩展字符串。只有取得该型号的扩展格式时才发送;如扩展定义要求 JSON,先序列化为字符串,不能直接放对象。未使用专用参数时省略。 |
ExtInfo 的外层类型固定为字符串,但内部内容由具体模型的扩展约定决定。不能仅凭类型是 String 就猜测 AdditionalParameters.template 的格式;拿到该场景对应的完整字段说明后再填写。普通视频不使用专用场景时可省略这些参数。
使用前需要确定的组合
先确定模板支持的 ModelName 和 ModelVersion,再确定 SceneType、模板标识、ExtInfo 编码、素材数量及 Usage,以及时长、比例和音频是否允许自定义。通用参数表没有列出的模板限制,应通过腾讯云创建接口参考及对应型号说明补齐。
在这些条件未确定前,本页不提供可复制提交的模板生成请求,避免用猜测参数创建收费任务。仅替换 Prompt 无法修复错误的模板或版本组合。
鉴权、任务与结果
腾讯云原生接口仍是 POST https://vod.tencentcloudapi.com/,Action 为 CreateAigcVideoTask,Version 为 2018-07-17,使用 TC3-HMAC-SHA256 签名。模板场景不是腾讯云新增的 /template-effect REST 路径,也不能用青云TOP API Key 直接访问腾讯云。
创建成功后保存 Response.TaskId,通过任务查询检查错误码与输出。SessionContext 不是回调 URL;本页也不承诺提供本站 webhook。
需要本站的视频特效或参考生成
可查看 Vidu 视频接入与模型选择和可灵视频接入与模型选择,按其已公布动作选择。不要把腾讯云的 SceneType/ExtInfo 搬入其他厂商格式。需要某个具体模板时,请向本站支持提供模板名称和输入需求,以确认是否有适用入口。