跳转到主要内容
GET
/
api
/
open-api
/
v1
/
videos
/
{taskId}
Query Video Task
curl --request GET \
  --url https://www.jimmyai.cn/api/open-api/v1/videos/{taskId} \
  --header 'Authorization: Bearer <token>'
{
  "code": "20000",
  "msg": "ok",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "result": {
      "video_url": "<string>",
      "image_url": "<string>"
    },
    "error_message": "<string>"
  }
}
[!IMPORTANT] 视频下载地址(video_url)的保存有效期为 3天,请及时转存。

任务状态说明

状态值 (status)说明对应进度 (progress)备注
queued / pending / submitted排队中 / 已提交。任务已成功提交,正在等待调度。0初始状态。
processing生成中。任务已开始在模型侧运行。1 - 99进度会随着生成过程实时更新。
completed成功。视频生成完成。100此时可在 result.video_url 获取生成的视频下载链接。
failed失败。视频生成任务运行出错。0可以在 error_message 字段中查看具体的失败原因。

状态机展示

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

taskId
string
必填

The ID of the task to query

响应

200 - application/json

Task status and result

code
string
示例:

"20000"

msg
string
示例:

"ok"

data
object