功能与适用范围
腾讯云点播通过一个异步创建动作承载文生视频、图生视频、首尾帧、参考素材和部分视频编辑能力。实际支持的输入取决于模型版本。提交成功后获得任务 ID，视频需要在任务完成后获取。
本目录暂不提供已确认可用的本站腾讯云视频入口。 原 POST /tencent-vod/v1/aigc-video 地址不能作为本站调用教程使用。先阅读接入状态与选择，不要将下面的腾讯云字段与本站 Bearer 鉴权混用。
官方模型与版本
下表是腾讯云点播原生 API 的型号参考，不是本站模型权限清单。同系列内的普通视频、场景、数字人、对口型或 3D 版本不具有相同的输入和产物。
| 腾讯云 ModelName | 对应 ModelVersion |
|---|---|
Hailuo | 02、2.3、2.3-fast、H3、H3_regen、H3-Max |
Kling | 1.6、2.0、2.1、2.5、2.6、O1、3.0、3.0-Omni、3.0-turbo、scene |
Vidu | q2、q2-pro、q2-turbo、q3、q3-pro、q3-turbo、q3-mix、q3-drama、q3-ad、scene、avatar-q2-pro、avatar-q2-turbo、lip-sync |
GV | 3.1、3.1-fast、3.1-lite、omni |
OS | 2.0 |
Hunyuan | 1.5、3d_2.0 |
Mingmou | 1.0 |
PixVerse | v5.6、v6、c1 |
系列级的时长范围不能视为每个版本的完整支持范围。例如 OutputConfig.Duration 对 Kling 列出 3～15 秒，不代表较早的 1.6 版本接受任意整数；音频开关列出 Kling，也不代表所有 Kling 版本支持音频。应同时按具体版本和动作限制选择组合。
原生鉴权与请求
腾讯云原生 API 地址是 POST https://vod.tencentcloudapi.com/，使用 Content-Type: application/json。请求头设置 X-TC-Action: CreateAigcVideoTask、X-TC-Version: 2018-07-17 和当前秒级 X-TC-Timestamp，Authorization 使用 TC3-HMAC-SHA256 签名；Region 为可选公共参数。
这属于腾讯云账号的直接调用，所需凭据与青云TOP API Key 不通用。不能仅把 Authorization 改为 Bearer，也不能只把域名换成 https://top.qingyuntop.ai。需要直接使用腾讯云服务时，可在官方 API Explorer选择动作，由官方工具生成完整的签名或 SDK 请求。
顶层请求参数
下面的字段位于 JSON 请求体。官方表格的 .N 表示数组元素，本页展示为 []。可选字段若未注明默认值，表示官方未声明统一默认；不要自行补入其他模型的默认值。
| 字段 | 类型·要求 | 含义、默认与限制 |
|---|---|---|
SubAppId | Integer；必填 | 点播应用 ID，填写实际应用 ID，不能照抄 0。 |
ModelName | String；必填 | 模型系列，允许值见模型表；不是本站 /v1/models 中的完整模型 ID。 |
ModelVersion | String；必填 | 该系列对应的版本，允许值见模型表；版本必须与动作和素材组合匹配。 |
FileInfos[] | Array of AigcVideoTaskInputFileInfo；可选，条件见说明 | JSON 中写作 FileInfos 数组。首帧 Usage=FirstFrame、末帧 Usage=LastFrame，各最多一张；允许只有首帧，不允许只有末帧。参考素材使用 Reference。首尾帧参考图片比例；参考模式可调比例。一般图片不超过 10M，jpeg/jpg/png。不是每个版本都支持所有输入方式。 |
SubjectInfos[] | Array of AigcVideoTaskInputSubjectInfo；可选，条件见说明 | JSON 中写作 SubjectInfos 数组；主体 ID、名称、图片或视频按模型规定提供，不等同于普通 FileInfos。 |
LastFrameFileId | String；可选，条件见说明 | 尾帧点播文件 ID；须同时用 FileInfos 指定首帧。图片小于 10M，jpeg/jpg/png/webp。 |
LastFrameUrl | String；可选，条件见说明 | 尾帧 URL；须同时用 FileInfos 指定首帧。图片小于 5M，jpeg/jpg/png/webp。不要与 FileInfos 内的尾帧重复指定。 |
Prompt | String；可选，条件见说明 | 视频内容、动作与镜头提示词。文生视频请显式填写非空文本；不要依赖省略 Prompt 的条件分支。官方未声明统一长度上限。 |
NegativePrompt | String；可选，条件见说明 | 希望避免的内容；按模型实际支持使用。 |
EnhancePrompt | String；可选，条件见说明 | Enabled / Disabled，是否自动优化提示词；官方未声明统一默认值。 |
OutputConfig | AigcVideoOutputConfig；可选，条件见说明 | 输出时长、分辨率、比例、存储等配置，见下表。 |
InputRegion | String；可选，条件见说明 | 输入文件所在区域：Mainland（默认）、Oversea、OverseaUSWest。不是生成 API 的 Region 请求头。 |
SceneType | String；可选，条件见说明 | Kling：motion_control（动作控制）、avatar_i2v（数字人）、lip_sync（对口型）；Vidu：template_effect（特效模板）。其他 ModelName 暂不支持。须同时符合具体型号的场景限制。 |
Procedure | String；可选，条件见说明 | 可选的后续点播任务流名称；未配置任务流时省略。 |
Seed | Integer；可选，条件见说明 | 随机种子，官方此字段未声明统一范围或默认值；按具体模型限制使用。 |
SessionId | String；可选，条件见说明 | 请求去重标识，最长 50 字符；不填或空串表示不去重。创建页声明三天，任务类型说明声明七天，请为每次新业务任务生成唯一值，重复请求不要依赖固定去重窗口。 |
SessionContext | String；可选，条件见说明 | 业务上下文，最长 1000 字符；避免放入密钥或个人敏感信息。它不是回调 URL。 |
TasksPriority | Integer；可选，条件见说明 | 整数 -10～10，越大优先级越高；默认 0。 |
ExtInfo | String；可选，条件见说明 | 模型专用扩展字符串。只有取得该型号的扩展格式时才发送；如扩展定义要求 JSON，先序列化为字符串，不能直接放对象。未使用专用参数时省略。 |
输入文件 FileInfos
每个文件对象必须与实际素材类型和模型能力匹配。普通首帧和尾帧各一张，可只有首帧，不能只有尾帧；参考素材应显式设置 Usage: Reference。参考图、首尾帧和待编辑视频不是同一种工作流。
| 字段 | 类型·要求 | 含义、默认与限制 |
|---|---|---|
FileInfos[].Type | String；可选，条件见说明 | File / Url / Base64；使用哪一种就填写对应 FileId / Url / Base64 字段。 |
FileInfos[].Category | String；可选，条件见说明 | Image / Video / Audio；只有目标版本支持该类素材时才使用。 |
FileInfos[].FileId | String；可选，条件见说明 | Type=File 时有效，填写点播媒体 ID；图片建议小于 10M，jpeg/jpg/png。 |
FileInfos[].Url | String；可选，条件见说明 | Type=Url 时有效，填写服务端可访问的素材 URL；图片建议小于 10M，jpeg/jpg/png。 |
FileInfos[].Base64 | String；可选，条件见说明 | Type=Base64 时有效，纯 Base64，不带 data: 前缀。所有原始文件大小合计不超过 7MB，以免编码后超过 10MB 请求体；图片 jpeg/jpg/png/webp，视频 mp4/mov/avi。仍须满足模型限制。 |
FileInfos[].ReferenceType | String；可选，条件见说明 | GV：asset（素材）/style（风格）；Kling 视频：feature（特征参考）/base（待编辑）；PixVerse 多图主体参考：subject/background。 |
FileInfos[].ObjectId | String；可选，条件见说明 | Vidu 图片主体 ID，可在 Prompt 中通过 @主体Id 引用。 |
FileInfos[].VoiceId | String；可选，条件见说明 | Vidu q2 图片主体音色；所有图片均携带主体 ID 时可设；使用厂商可用音色 ID。 |
FileInfos[].KeepOriginalSound | String；可选，条件见说明 | 视频是否保留原声：Enabled / Disabled；只对 Category=Video 有效。 |
FileInfos[].Usage | String；可选，条件见说明 | FirstFrame（默认）、LastFrame、Reference。首尾帧各一张，末帧依赖首帧；不要依赖输入顺序替代 Usage。 |
FileInfos[].Text | String；可选，条件见说明 | 仅 PixVerse 多图主体参考有效；给图片命名，Prompt 用 @名称 后跟空格引用。 |
SubjectInfos 是另一种主体引用结构；Kling 的主体 ID 与 Vidu 的名称、临时主体图片/视频有不同条件。需要此功能时先查看官方主体字段，不要将普通图片数组直接改名为 SubjectInfos。
输出配置 OutputConfig
以下范围来自腾讯云系列级参数说明，仍需与具体版本、动作和素材相交使用。未在表内说明的模型组合应先查明其专属限制，不填猜测值。
| 字段 | 类型·要求 | 含义、默认与限制 |
|---|---|---|
OutputConfig.StorageMode | String；可选，条件见说明 | Temporary（默认）：临时存储，官方说明链接有效期 7 天。Permanent：存储到点播。最终保存期限按结果及应用存储配置处理。 |
OutputConfig.MediaName | String；可选，条件见说明 | 输出名称，最长 64 字符；省略时自动生成。 |
OutputConfig.ClassId | Integer；可选，条件见说明 | 媒体分类 ID，默认 0（其他分类）。 |
OutputConfig.ExpireTime | String；可选，条件见说明 | 输出文件过期时间，ISO 8601。不要把该字段的默认不过期说明套用到 Temporary 临时链接。 |
OutputConfig.Duration | Float；可选，条件见说明 | 秒数。系列表：Kling 3～15，默认 5；Hailuo 6/10，默认 6，H3 为 4～15 整数；Vidu 1～10；GV 8；OS 4/8/12，默认 8；PixVerse 1～15，默认 5。这里是系列范围，不保证每个版本支持全部值；无具体版本组合依据时不要直接采用上限。 |
OutputConfig.Resolution | String；可选，条件见说明 | Kling/Vidu/GV：720P（默认）或 1080P；Hailuo：768P（默认）或 1080P，H3 另列 2K/4K；OS：720P；PixVerse：540p/720p/1080p/2k/4k，默认 720p。大小写按对应型号填写；最终组合以型号限制为准。 |
OutputConfig.AspectRatio | String；可选，条件见说明 | Kling 文生：16:9（默认）/9:16/1:1；Vidu 文生或参考：16:9/9:16/1:1，4:3/3:4 仅 q2；GV：16:9（默认）/9:16；OS 文生：16:9（默认）/9:16；Hailuo H3 文生或参考：21:9/16:9/4:3/1:1/3:4/9:16，图生参考输入图片；PixVerse：16:9/4:3/1:1/3:4/9:16/2:3/3:2/21:9。 |
OutputConfig.AudioGeneration | String；可选，条件见说明 | Enabled / Disabled（默认）。系列说明列 GV/OS/Vidu/Kling 等，仍须确认具体版本支持有声输出；不能由这个开关推断所有版本能生音频。 |
OutputConfig.PersonGeneration | String；可选，条件见说明 | AllowAdult（允许成人）或 Disallowed（禁止人物/人脸）；按模型支持使用，未声明统一默认值。 |
OutputConfig.InputComplianceCheck | String；可选，条件见说明 | Enabled / Disabled；输入内容检查选项，具体适用范围按厂商规定，不代表可以绕过内容规则。 |
OutputConfig.OutputComplianceCheck | String；可选，条件见说明 | Enabled / Disabled；输出内容检查选项，具体适用范围按厂商规定。 |
OutputConfig.EnhanceSwitch | String；可选，条件见说明 | Enabled / Disabled，视频增强；目标分辨率超出模型直出范围时官方说明会默认增强。增强结果不等于模型原生分辨率。 |
OutputConfig.OffPeak | String；可选，条件见说明 | Enabled / Disabled，错峰选项；不据此承诺本站价格、退款或完成时效。 |
OutputConfig.FrameInterpolate | String；可选，条件见说明 | Enabled / Disabled，Vidu 智能插帧；未声明统一默认值。 |
OutputConfig.LogoAdd | String；可选，条件见说明 | Enabled / Disabled，图标水印；未声明统一默认值。 |
OutputConfig.EnableBGM | String；可选，条件见说明 | Enabled / Disabled（默认），从预设音乐库添加背景音乐，与模型原生音频生成不同。 |
创建响应与下一步
成功响应的 Response.TaskId 是字符串，用于查询同一任务；Response.RequestId 是本次请求追踪 ID。二者不能互换。任务受理不代表生成成功，也不代表已有可下载的 MP4。
查询使用同一腾讯云服务的 DescribeTaskDetail，详见查询任务与处理结果。不要把腾讯云任务 ID 填入本站 /v1/videos/{id} 或 /v1/tasks/{id}；不同入口的 ID 和结果结构不能混用。
常见错误
- 参数错误：检查字段大小写，使用
ModelName/ModelVersion、FileInfos数组、字符串ExtInfo和整数TasksPriority。旧的 snake_case 请求体不能直接提交给腾讯云。 - 素材错误：核对公开 URL 可访问性、格式、大小、Usage 和所选模型是否支持对应输入。
- 签名错误：检查请求体与签名一致、时间戳有效，以及 Content-Type 和签名头一致。
- 创建超时：先保存业务去重标识和已收到的 TaskId，避免因响应丢失而批量重复生成。