> ## Documentation Index
> Fetch the complete documentation index at: https://doc.deepwl.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax-H3 查询任务（统一格式）

> 使用 `GET /v1/video/query?id=` 查询 MiniMax-H3 视频任务状态与结果。

# MiniMax-H3 查询任务（统一格式）

通过**查询参数 `id`** 获取视频生成或 2K 再生成任务的状态。任务完成后，视频限时下载地址位于 `video_url` 字段。状态流转、响应字段与轮询建议与 [OpenAI 格式的任务查询](./query) 一致。

## 方法与路径

```http theme={null}
GET /v1/video/query?id={task_id}
```

<RequestExample>
  ```bash cURL theme={null}
  curl "https://zx1.deepwl.net/v1/video/query?id=task_a1b2xxxxx5f6" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

## Query Parameters

<ParamField query="id" type="string" required>
  创建接口返回的任务 `id`。注意本路由的参数名是 `id`，不是 `task_id`。
</ParamField>

## 响应示例

<ResponseExample>
  ```json 200 - 已完成 theme={null}
  {
    "id": "task_a1b2xxxxx5f6",
    "object": "video",
    "model": "MiniMax-H3",
    "status": "completed",
    "progress": 100,
    "created_at": 1785125529,
    "completed_at": 1785125946,
    "seconds": "5",
    "size": "2K",
    "video_url": "https://cdn.example.com/h3-generated-2k-output.mp4",
    "metadata": {
      "url": "https://cdn.example.com/h3-generated-2k-output.mp4",
      "ratio": "16:9"
    }
  }
  ```

  ```json 400 theme={null}
  {
    "code": "task_not_exist",
    "message": "task_not_exist",
    "data": null
  }
  ```
</ResponseExample>

响应字段含义与 [任务查询（OpenAI 格式）](./query) 一致。

## 错误码

| HTTP 状态码 | 说明                |
| -------- | ----------------- |
| `400`    | 任务不存在或已超出 7 天查询窗口 |
| `401`    | 鉴权失败              |
| `500`    | 服务端错误             |

## 相关接口

* [MiniMax-H3 视频概览](./overview)
* [创建视频（统一格式）](./unified-generation)
* [2K 再生成（统一格式）](./unified-remix)
* [任务查询（OpenAI 格式）](./query)