CreateVideoTask - 创建视频生成任务-AI 数据标识(AI DeepSign )-阿里云帮助中心

创建视频生成任务

接口说明

请求说明

本接口用于创建 AI 视频生成任务，系统将依据用户提供的正向提示词（Prompt）生成相应的视频。
默认情况下，生成的视频会自动嵌入 C2PA 数字签名；
创建任务后，使用TaskId调用GetVideoTaskResult接口查询生成结果。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

aideepsign:CreateVideoTask

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	幂等参数	f47ac10b-58cc-4372-a567-0e02b2c3d479
Prompt	string	否	视频描述提示词。与 Media 必填其一（纯文生视频仅需 Prompt）	一间全是猫的会议室
Model	string	否	模型名：wan3.0-video（默认）/ wan3.0-video-prime（高速版）	wan3.0-video
Media.1.Type	string	否	素材类型（第 1 条）：first_frame/last_frame/reference_image/reference_video/reference_audio/file/link	JPEG
Media.1.Url	string	否	素材地址（第 1 条）：公网 http(s) URL / oss:// 临时 URL / data:{mime};base64,... 内联数据	图片地址
Media.2.Type	string	否	素材类型（第 2 条）：first_frame/last_frame/reference_image/reference_video/reference_audio/file/link	JPEG
Media.2.Url	string	否	素材地址（第 2 条）：公网 http(s) URL / oss:// 临时 URL / data:{mime};base64,... 内联数据	图片地址
Resolution	string	否	分辨率：1080P（默认）/720P/480P	1080P
Ratio	string	否	画面比例：adaptive（默认）/16:9/4:3/1:1/3:4/9:16	adaptive
Duration	integer	否	视频时长（秒）：[2,30] 或 -1（智能时长）；0 = 服务端默认 5 秒	2
Audio	boolean	否	是否包含音轨，默认 true	true
Seed	integer	否	随机种子：-1（随机）或 [0,2147483647]；0 = 服务端默认随机	42
PromptExtend	boolean	否	是否开启智能改写（prompt_extend），默认 true	true
Watermark	boolean	否	是否添加百炼水印，默认 false	false

返回参数

名称	类型	描述	示例值
	object	Schema of Response
Code	string	返回码	OK
HttpStatusCode	integer	HTTP 状态码。请求成功时返回 200。	200
Message	string	附加信息。请求成功时返回 success。	success
RequestId	string	Id of the request	A1B2C3D4-E5F6-7890-ABCD-EF1234567890
Success	boolean	表示是否调用成功。true：调用成功。 false：调用失败。	true
TaskId	string	任务 ID，用于查询生成结果	f47ac10b-58cc-4372-a567-0e02b2c3d479

示例

正常返回示例

JSON格式

{
  "Code": "OK",
  "HttpStatusCode": 200,
  "Message": "success",
  "RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
  "Success": true,
  "TaskId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}

错误码

HTTP status code	错误码	错误信息	描述
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。