j9九游会登录/ 大模型即服务平台 maas/ 用户指南/ maas api调用规范/ / 查询视频生成任务
更新时间：2026-01-15 gmt 08:00

查询视频生成任务-j9九游会登录

查询视频生成任务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脚本和curl命令查询视频生成任务的状态和结果为例。

  • 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
}
父主题：

相关文档

网站地图