跳转到主要内容
GET
/
v1
/
videos
/
tasks
/
{task_id}
查询视频任务状态
curl --request GET \
  --url https://openapi.imini.ai/imini/router/v1/videos/tasks/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "task_id": "task_2042864638838083584",
  "status": "succeeded",
  "model": "kling/kling-v3",
  "created_at": "2026-04-11T07:17:39.146Z",
  "completed_at": "2026-04-11T07:19:57.844Z",
  "videos": [
    {
      "url": "https://file.iminicdn.com/file/2026/04/11/2042865212863942656.mp4",
      "width": 1284,
      "height": 716,
      "duration": 5,
      "cover_url": "https://file.iminicdn.com/file/2026/04/11/2042865212863942700.jpg"
    }
  ],
  "error": null,
  "request_id": "req_abc123"
}

授权

​
Authorization
string
header
必填

在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。前往 API Keys 管理页 创建和管理 API Key。

路径参数

​
task_id
string
必填

任务唯一 ID，由视频生成接口返回。

示例:

"task_2042864638838083584"

响应

查询成功

​
task_id
string

任务唯一 ID

示例:

"task_2042864638838083584"

​
status
enum<string>

任务状态：

  • queued — 已提交，等待队列
  • processing — 模型生成中
  • succeeded — 生成成功
  • failed — 生成失败，见 error 字段
可用选项:
queued,
processing,
succeeded,
failed
示例:

"succeeded"

​
model
string

本次任务使用的模型 ID

示例:

"kling/kling-v3"

​
created_at
string<date-time>

任务创建时间（ISO 8601）

示例:

"2026-04-11T07:17:39.146Z"

​
completed_at
string<date-time> | null

任务完成时间（ISO 8601），未完成时为 null

示例:

"2026-04-11T07:19:57.844Z"

​
videos
object[] | null

生成结果列表，status 为 succeeded 时有值，否则为 null

​
error
object

错误信息，status 为 failed 时有值，否则为 null

​
request_id
string

请求唯一 ID

示例:

"req_abc123"