创建AIGC生视频任务

最近更新时间:2026-05-26 02:22:04

我的收藏

1. 接口描述

接口请求域名: mps.tencentcloudapi.com 。

调用该接口,用于创建AI生视频任务。

默认接口请求频率限制:10次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateAigcVideoTask。
Version String 公共参数,本接口取值:2019-06-12。
Region String 公共参数,此参数为可选参数。
ModelName String

模型名称。
当前支持的模型列表:
Hunyuan,
Hailuo,
Kling,
Vidu,
PixVerse,
Mingmou,
H2。


示例值:Hunyuan
ModelVersion String

指定模型特定版本号。默认使用系统当前所支持的模型稳定版本。

  1. Hunyuan,可选 [1.5]。
  2. Hailuo,可选 [02、2.3、2.3-fast]。
  3. Kling,可选 [1.6、2.0、2.1、2.5、O1、2.6、3.0、3.0-Omni]。
  4. Vidu,可选 [q2、q2-pro、q2-turbo、q3-pro、q3-turbo、q3、q3-mix]。
  5. PixVerse,可选 [v5.6、v6、c1]。
  6. H2,可选 [1.0]。

示例值:1.5
SceneType String

指定场景生视频。
注意:仅部分模型支持指定场景。

  1. Kling支持:动作控制,motion_control;数字人,avatar_i2v;对口型,lip_sync。
  2. Mingmou支持:横转竖,land2port。
  3. Vidu支持:特效模板,template_effect。

示例值:motion_control
Prompt String

生成视频的描述。当未传入图片时,此参数必填。


示例值:move the picture
NegativePrompt String

用于描述您想要阻止模型生成的内容。
注意:部分模型支持。
例如:
顶部照明、明亮的色彩。
人物、动物。
多辆汽车、风。


示例值:Top lighting, bright colors
EnhancePrompt Boolean

默认取值为False,模型会严格地遵循指令。
如果需要更精细的prompt获得最佳效果,可将此参数设置为True,将自动优化传入的prompt,以提升生成质量。


示例值:false
ImageUrl String

用于指导视频生成的图片 URL。该URL需外网可访问。
注意:

  1. 推荐图片大小不超过10M,不同模型大小限制不相同,可查看相应模型官网获取更完整描述。
  2. 支持的图片格式:jpeg、png。

示例值:https://1500039689.vod-xxx.com/6cd2c44bvodcq1500039689/179cafb25145403699605999621/xxdjoxE6jcA.png
LastImageUrl String

模型将以此参数传入的图片作为尾帧画面来生成视频。
支持此参数的模型:

  1. Kling,2.0、O1、3.0、3.0-Omni 支持首尾帧。
  2. Kling,1.6、2.1、2.5、2.6 在 Resolution:1080P 的情况下支持首尾帧。
  3. Vidu,q2-pro、q2-turbo、q3-pro、q3-turbo 支持首尾帧。
  4. PixVerse,v5.6、v6、c1 支持首尾帧。
  5. Hailuo,02 支持首尾帧。

注意:

  1. 推荐图片大小不超过10M,各模型限制不同。
  2. 支持的图片格式:jpeg、png。

示例值:https://aigc-xxx-image-1303333058.cos.ap-guangzhou.myqcloud.com/xxx_8655.png
ImageInfos.N Array of AigcVideoReferenceImageInfo

包含多张素材资源图片的列表,用于描述模型在生成视频时要使用的资源图片。

支持多图输入的模型:

  1. Vidu,q2、q2-pro、q3-turbo、q3、q3-mix 支持多图参考生视频。支持上传 1-7 张图片,可通过 ImageInfos 里面的 ReferenceType 作为主体 id 来传入。
  2. Kling,O1、3.0-Omni、1.6 支持多图参考生视频。
    1. Kling 1.6 支持上传 1-4 张图片。
    2. Kling O1、3.0-Omni 支持上传 1-7 张图片。当有参考视频时,支持上传 0-4 张图片。
  3. PixVerse,v5.6、v6、c1 支持多图参考生视频。支持上传 1-7 张图片,需要通过 ImageInfos 里面的 Text 字段传入图片名称。
  4. H2,1.0 支持多图参数生视频。支持上传 1-9 张图片。当有参考视频时,支持上传 0-5 张图片。

注意:

  1. 图片大小不超过10M。
  2. 支持的图片格式:jpeg、png。
VideoInfos.N Array of AigcVideoReferenceVideoInfo

目前仅 Kling O1、Kling 3.0-Omni、Vidu q2-pro、H2 1.0 支持参考视频信息传入。

  1. Kling O1、3.0-Omni 可作为特征参考视频,也可作为待编辑视频,默认为待编辑视频;可选择性保留视频原声。
  2. Vidu q2-pro 支持视频参考。
  3. H2 1.0 支持视频参考。
Duration Integer

生成视频的时长。
注意:

  1. Kling,默认:5 秒。
    • O1 支持 3-10 秒。
    • 3.0-Omni 支持 3-15 秒,当使用视频参考时只支持 3-10 秒。
    • 3.0 支持 3-15 秒。
    • 其他版本支持 5、10 秒。
  2. Hailuo 的 std 模式可支持 6、10 秒,其他仅 6 秒。默认:6 秒。
  3. Vidu,默认:5 秒。
    • q3-pro、q3-turbo、q3、q3-mix 支持 3-16 秒。
    • q2-pro、q2-turbo、q2 支持 1-10 秒。
  4. PixVerse,默认:5 秒。
    • v5.6 支持 5、8、10 秒。
    • v6、c1 支持 1-15 秒。
  5. H2,支持 3-15 秒,默认 :5 秒。

示例值:8
ExtraParameters AigcVideoExtraParam

用于传入要求的额外参数。

StoreCosParam AigcStoreCosParam

文件结果指定存储Cos桶信息。 注意:需开通Cos,创建并授权MPS_QcsRole角色。

AdditionalParameters String

用于传入一些模型需要的特殊场景参数、分镜prompt等,Json格式序列化成字符串。
示例:
{"camera_control":{"type":"simple"}}


示例值:{"test":1}
Operator String

接口操作者名称。


示例值:admin

3. 输出参数

参数名称 类型 描述
TaskId String

任务创建成功后,返回的任务ID。
调用查询接口,轮询获取任务进度及生成结果。


示例值:2147483792
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 请求示例

输入示例

POST / HTTP/1.1
Host: mps.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateAigcVideoTask
<公共请求参数>

{
    "ModelName": "Hunyuan",
    "Prompt": "move the picture",
    "NegativePrompt": "Top lighting,bright colors",
    "EnhancePrompt": false,
    "ImageUrl": "https://1500039689.vod-**.com/6cd2c44bvodcq1500039689/179cafb25145403699605999621/**oxE6jcA.png",
    "LastImageUrl": "https://aigc-**-image-1303333058.cos.ap-guangzhou.myqcloud.com/xxx_8655.png",
    "Duration": 5,
    "ExtraParameters": {
        "Resolution": "720P",
        "AspectRatio": "16:9"
    },
    "StoreCosParam": {
        "CosBucketName": "aigc-***-video-1**58",
        "CosBucketRegion": "ap-guangzhou",
        "CosBucketPath": "my_cos_file"
    },
    "Operator": "admin"
}

输出示例

{
    "Response": {
        "TaskId": "2147**3792",
        "RequestId": "643fb583-0032-44ac-bfa8-bef25e310998"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InvalidParameter.ViolationContent 输入审核拦截。