> ## 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 Query Task (Unified Format)

> Query a MiniMax-H3 video task status and result with `GET /v1/video/query?id=`.

# MiniMax-H3 Query Task (Unified Format)

Retrieves the status of a video generation or 2K regeneration task via the **`id` query parameter**. Once the task completes, the time-limited download URL is in the `video_url` field. The status flow, response fields, and polling guidance are identical to [OpenAI-format Task Query](./query).

## Method and Path

```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>
  The task `id` returned by the create endpoint. Note the parameter name on this route is `id`, not `task_id`.
</ParamField>

## Response Example

<ResponseExample>
  ```json 200 - Completed 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>

Response fields match [Task Query (OpenAI Format)](./query).

## Error Codes

| HTTP Status | Description                                              |
| ----------- | -------------------------------------------------------- |
| `400`       | Task does not exist or is outside the 7-day query window |
| `401`       | Authentication failed                                    |
| `500`       | Server error                                             |

## Related Endpoints

* [MiniMax-H3 Video Overview](./overview)
* [Create Video (Unified Format)](./unified-generation)
* [2K Regeneration (Unified Format)](./unified-remix)
* [Task Query (OpenAI Format)](./query)