创建文生视频任务

功能介绍

支持调用多模态视频大模型创建文生视频的推理任务。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/alg-infer/aigc-text-video/service/{deployment_id}/videos

获取URI方式请参见请求URI。

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID。约束限制：不涉及取值范围：不涉及默认取值：不涉及
deployment_id	是	String	参数解释：模型的部署ID，获取方法请参见获取模型部署ID。约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。用于获取操作API的权限。如图4中响应消息头中X-Subject-Token的值即为Token。约束限制：不涉及取值范围：不涉及默认取值：不涉及
Content-Type	是	String	参数解释：发送的实体的MIME类型。约束限制：不涉及取值范围：不涉及默认取值： application/json

表3 请求Body参数
参数	是否必选	参数类型	描述
prompt	是	String	参数解释：提示词。约束限制：支持中英文。长度小于等于1000。取值范围：不涉及。默认取值：不涉及。
video_config	否	VideoConfig object	生成视频的配置信息

表4 VideoConfig
参数	是否必选	参数类型	描述
resolution	否	String	参数解释：分辨率。约束限制：不涉及。取值范围：不涉及。默认取值： 720p
duration	否	int	参数解释：生成的视频时长，单位秒。约束限制：不涉及。取值范围：不涉及。默认取值： 5
aspect_ratio	否	String	参数解释：生成的视频宽高比。约束限制：不涉及。取值范围： 16:9、9:16、4:3、3:4、1:1 默认取值： 16:9

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
id	String	用来标识视频生成任务的唯一字符串。
prompt	String	提示词。
status	String	视频生成的任务状态。
video_url	String	视频生成结果文件链接。
video_config	VideoConfig object	生成视频的配置信息。

状态码： 400

表6 响应Body参数
参数	参数类型	描述
error_msg	String	错误信息
error_code	String	错误码

请求示例

POST https://{endpoint}/v1/{project_id}/alg-infer/aigc-text-video/service/{deployment_id}/videos

Request Header:   
Content-Type: application/json   
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      

Request Body:
{
    "prompt": "prompt",
    "video_config": {
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
}

响应示例

{
    "id": "e7c33de0-1245-42d9-a875-745845ce3b22",
    "prompt": "prompt",
    "status": "PROCESSING",
    "video_config": {
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
}