文档首页/ AI开发平台ModelArts/ ModelArts Studio（MaaS）用户指南/ ModelArts Studio（MaaS）在线推理服务/ ModelArts Studio（MaaS） API调用规范/ 视频生成/ 查询视频生成任务
更新时间：2025-09-30 GMT+08:00
查看PDF
分享

查询视频生成任务

查询视频生成任务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

任务状态。取值如下：

  • queued：排队中
  • running：运行中
  • succeeded：成功
  • failed：失败
  • timeout：超时

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地址。请将task_id替换为实际的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
}
父主题： 视频生成

相关文档