查询图生视频任务详情

功能介绍

根据创建图生视频任务返回的ID获取图生视频的任务详情。

授权信息

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

URI

GET /v1/{project_id}/alg-infer/aigc-img-video/service/{deployment_id}/videos/{video_task_id}

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

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

请求参数

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

响应参数

状态码：200

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

状态码： 400

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

请求示例

GET https://{endpoint}/v1/{project_id}/alg-infer/aigc-img-video/service/{deployment_id}/videos/{video_task_id}

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

响应示例

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