更新时间:2025-09-16 GMT+08:00
分享

查询图生视频任务详情

功能介绍

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

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

Strng

视频生成结果文件链接。

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"
    }
}

状态码

请参见状态码

错误码

请参见错误码

相关文档