查询任务结果 API

概述

查询生成任务（视频生成、图像生成）的执行状态和结果。支持实时获取任务进度、完成状态以及生成的文件链接。

接口信息

基础URL

支持的端点

请求地址	描述
`GET /v1/tasks/generations/{request_id}`	查询视频生成任务状态

内容类型： application/json

**认证方式：**Bearer Token

请求头示例：

请求参数

路径参数

参数名	类型	必填	描述	示例
`request_id`	string	是	生成任务的唯一标识符	`20250829155118560120000jnBOAS1q`

响应结构

基础响应结构

字段名	类型	必填	描述	示例值
`code`	string	是	响应状态码，"success" 表示成功	`"success"`
`message`	string	是	响应消息，通常为空字符串	`""`
`data`	object	是	任务详细信息对象	-

任务信息字段 (data)

字段名	类型	必填	描述	示例值
`request_id`	string	是	请求的唯一标识符，与请求路径中的 request_id 一致	`"20250829155118560120000jnBOAS1q"`
`task_id`	string	是	任务 ID，系统内部生成的任务标识符	`"68b15bf74887835d7cf6e20c"`
`action`	string	是	任务类型	`"VIDEO_GENERATION"`
`status`	string	是	任务状态，详见任务状态说明	`"COMPLETED"`
`fail_reason`	string	是	失败原因，任务成功时为空	`""`
`submit_time`	number	是	任务提交时间戳（Unix 时间戳，秒）	`1756453878`
`start_time`	number	是	任务开始处理时间戳（Unix 时间戳，秒）	`1756453879`
`finish_time`	number	是	任务完成时间戳（Unix 时间戳，秒），未完成时为 0	`1756454093`
`progress`	string	是	任务进度百分比	`"100%"`
`data`	object	是	任务结果数据对象	-

任务结果字段 (data.data)

字段名	类型	必填	描述	示例值
`video_urls`	string[]	否	生成的视频文件 URL 列表（任务完成时返回）	-
`image_urls`	string[]	否	生成的图像文件 URL 列表（任务完成时返回）	-
`progress`	number	是	数值型进度，范围 0-100	`100`

支持的任务类型

任务类型	结果字段名	描述
`VIDEO_GENERATION`	`video_urls`	视频文件 URL
`IMAGE_GENERATION`	`image_urls`	图像文件 URL

任务状态说明

状态枚举

状态	描述	是否终态
`SUBMITTING`	提交中，任务正在提交到系统	否
`PENDING`	待处理，任务已接收但尚未开始处理	否
`SUBMITTED`	已提交，任务已成功提交到处理队列	否
`QUEUED`	排队中，任务在队列中等待资源分配	否
`IN_PROGRESS`	执行中，任务正在处理中	否
`COMPLETED`	已完成，任务成功完成并生成结果	是
`FAILED`	失败，任务处理失败	是
`CANCELLED`	已取消，任务被用户或系统取消	是
`TIMEOUT`	超时，任务处理超时	是
`UNKNOWN`	未知状态，无法确定任务当前状态	是

响应示例

视频生成任务完成响应

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "20250829203307450589000g8uiOTne",
    "task_id": "5146084766223245044",
    "action": "VIDEO_GENERATION",
    "status": "COMPLETED",
    "fail_reason": "",
    "submit_time": 1756470787,
    "start_time": 1756470794,
    "finish_time": 1756471004,
    "progress": "100%",
    "data": {
      "video_urls": [
        "https://v9-vvecloud.yangyi08.com/6f1c2a9f57c6c539c54331d548bf0cd0/68b1acf1/video/tos/cn/tos-cn-v-242bcc/o0NosADfEABEACsZfKUgETAFUZxEC8m7s6F1Cn/?a=7073&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=5319&bt=5319&cs=0&ds=3&ft=xztlUQhhe6BMyqDAeqkJD12Nzj&mime_type=video_mp4&qs=13&rc=Mzk8PHA5cmtzNTgzNGczM0BpMzk8PHA5cmtzNTgzNGczM0Byc2kuMmQ0cWxhLS1kXi9zYSNyc2kuMmQ0cWxhLS1kXi9zcw%3D%3D&btag=c0000e00008000&dy_q=1756471004&l=202508292036448A69AA5F890D92F749A9"
      ],
      "progress": 100
    }
  }
}

图像生成任务完成响应

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "20250829203041325320000CFVslBwb",
    "task_id": "8243869831046584480",
    "action": "IMAGE_GENERATION",
    "status": "COMPLETED",
    "fail_reason": "",
    "submit_time": 1756470641,
    "start_time": 1756470644,
    "finish_time": 1756470674,
    "progress": "100%",
    "data": {
      "image_urls": [
        "https://shengsuanyun.oss-cn-shanghai.aliyuncs.com/example/generations/jimeng/jimeng_image_1756470674284330000_9666ec558a17f909.jpg"
      ],
      "progress": 100
    }
  }
}

任务排队中响应

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "20250829203041325320000CFVslBwb",
    "task_id": "8243869831046584480",
    "action": "IMAGE_GENERATION",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1756470641,
    "start_time": 1756470644,
    "finish_time": 0,
    "progress": "20%",
    "data": {}
  }
}

任务失败响应

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "20250829160811960562000mc6xea13",
    "task_id": "",
    "action": "VIDEO_GENERATION",
    "status": "FAILED",
    "fail_reason": "upstream API error: status=400, body={\"error\":{\"code\":\"invalid_video_generation_argument\",\"message\":\"duration is invalid, please check parameter\",\"type\":\"invalid_request_error\"},\"id\":\"as-4frq5phudc\"}",
    "submit_time": 1756454892,
    "start_time": 1756454892,
    "finish_time": 1756454892,
    "progress": "100%",
    "data": {}
  }
}

进行中任务响应

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "20250829155118560120000jnBOAS1q",
    "task_id": "68b15bf74887835d7cf6e20c",
    "action": "VIDEO_GENERATION",
    "status": "IN_PROGRESS",
    "fail_reason": "",
    "submit_time": 1756453878,
    "start_time": 1756453879,
    "finish_time": 0,
    "progress": "45%",
    "data": {}
  }
}

错误响应

当请求本身失败时（如任务不存在），返回错误格式：

{
  "code": "task_not_exist",
  "message": "task_not_exist",
  "data": null
}

常见错误码

错误码	HTTP 状态码	描述	解决方案
`task_not_exist`	404	任务不存在或已过期	检查 request_id 是否正确
`invalid_request_id`	400	请求 ID 格式不正确	使用正确格式的 request_id
`access_denied`	403	无权限访问该任务	检查认证信息和访问权限

使用指南

轮询策略

查询频率：建议每隔 3-5 秒查询一次任务状态

终止条件：当状态变为终态时停止轮询

成功终态：COMPLETED

失败终态：FAILED、CANCELLED、TIMEOUT、UNKNOWN

注意事项

项目	说明
URL 有效期	返回的文件 URL 有效期为 24 小时，请及时下载或保存
错误处理	当状态为失败终态时，查看 `fail_reason` 字段了解具体原因
状态监控	关注任务在各个状态的停留时间，异常停留可能需要重新提交任务
重试策略	对于 `TIMEOUT` 或 `FAILED` 状态的任务，可以考虑重新提交

概述#

接口信息#

基础URL#

支持的端点#

请求参数#

路径参数#

响应结构#

基础响应结构#

任务信息字段 (data)#

任务结果字段 (data.data)#

支持的任务类型#

任务状态说明#

状态枚举#

响应示例#

视频生成任务完成响应#

图像生成任务完成响应#

任务排队中响应#

任务失败响应#

进行中任务响应#

错误响应#

常见错误码#

使用指南#

轮询策略#

注意事项#

概述