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

查询视频生成任务

查询视频生成任务API用于根据任务ID查询视频生成任务的状态和结果。

接口信息

表1 接口信息

名称

说明

取值

API地址

查询视频生成任务的API地址,需要在链接末尾拼接生成任务的task_id。

task_id可以通过创建视频生成任务API获取。

https://api.modelarts-maas.com/v1/video/generations/{task_id}

请求参数说明

参数名称

参数类型

是否必填

说明

task_id

string

要查询的视频生成任务ID,需拼接在查询API末尾处,可以通过创建视频生成任务API获取。

响应参数说明

表2 响应参数

参数名称

参数类型

说明

task_id

string

任务ID。

status

string

任务状态。

error

object

错误提示信息。关于子参数的说明,请参见表3

content

object

生成的视频内容信息。关于子参数的说明,请参见表4

usage

object

任务的Token用量。关于子参数的说明,请参见表5

created_at

integer

任务创建时间的Unix时间戳(秒)。

updated_at

integer

任务状态更新时间的Unix时间戳(秒)。

表3 error子参数

参数名称

参数类型

说明

code

integer

错误码。任务状态为成功时,返回0。

message

string

报错信息。

表4 content子参数

参数名称

参数类型

说明

result_url

string

图片/文本生成视频的URL。该URL有效期为24小时,请注意及时下载转存。

表5 usage子参数

参数名称

参数类型

说明

model_latency

integer

从模型收到请求到返回结果的端到端时延(毫秒)。

completion_tokens

integer

模型生成内容的消耗Token数。

prompt_tokens

integer

用户输入Token数。

total_tokens

integer

总消耗Token数。

请求示例

  • Python示例:
    import requests 
    import json
    
    if __name__ == '__main__': 
        url = "https://api.modelarts-maas.com/v1/video/generations/{task_id}" # API地址 
        api_key = "MAAS_API_KEY"  # 把yourApiKey替换成已获取的API Key  
    
        # Send request. 
        headers = { 
            'Content-Type': 'application/json', 
            'Authorization': f'Bearer {api_key}'  
        } 
        response = requests.get(url, headers=headers, verify=False) 
    
        # Print result. 
        print(response.status_code) 
        print(response.text)
  • cURL示例:
    curl -X GET 'https://api.modelarts-maas.com/v1/video/generations/{task_id}' \ 
      -H "Content-Type: application/json" \ 
      -H "Authorization: Bearer $MAAS_API_KEY"

响应示例

{
    "task_id": "330b74a382a6d42044f146f389cd698e",
    "status": "succeeded",
    "error": {
        "code": 0,
        "message": ""
    },
    "content": {
        "result_url": "https://modelarts.obs.com/example.mp4"
    },
    "usage": {
        "model_latency": 43564,
        "completion_tokens": 124800,
        "prompt_tokens": 0,
        "total_tokens": 124800
    },
    "created_at": 1751894112234,
    "updated_at": 1751894156753
}

相关文档