---
title: "视频任务查询接口"
method: GET
path: "/videos/{task_id}"
tags: ["Video"]
---

# 视频任务查询接口

`GET /videos/{task_id}`

根据任务ID查询视频生成任务的状态和结果。

## Path parameters

- `task_id` string, uuid, required

## Response `200`

成功响应

- object
  - `model` string, required — 使用的视频模型
  - `task_id` string, uuid, required — 任务ID
  - `task_status` 'pending' | 'running' | 'succeed' | 'failed', required — 任务状态
  - `video_result` object — 视频生成结果(仅在生成成功时返回)
    - `url` string, uri — 视频URL
    - `cover_image_url` string, uri — 封面图片URL
    - `duration` number — 实际视频时长(秒)
    - `revised_prompt` string — 增强后的提示文本
  - `error` object — 错误信息(仅在生成失败时返回)
    - `code` string — 错误代码
    - `message` string — 错误描述
    - `details` object — 详细错误信息

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `404` — 任务不存在
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)