> ## 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 2K 再生成（统一格式）

> 使用 `POST /v1/video/remix` 将 MiniMax-H3 的 768P 视频再生成为 2K。

# MiniMax-H3 2K 再生成（统一格式）

统一格式通过**请求体中的 `task_id`** 指定源任务，将符合 MiniMax-H3 输出规格的 768P 视频再生成为 2K。其余字段与限制与 [OpenAI 格式的 2K 再生成](./remix) 一致。

## 方法与路径

```http theme={null}
POST /v1/video/remix
```

## 源视频传参方式

| 方式         | 参数                    | `prompt`         |
| ---------- | --------------------- | ---------------- |
| 按任务 ID（推荐） | 请求体 `task_id`         | 无需传入             |
| 按源视频 URL   | `metadata.base_video` | 必填，且须与原始生成请求完全一致 |

按任务 ID 再生成需要上游开通白名单，且源任务仍在 7 天查询窗口内。按源视频 URL 再生成时，必须原样附上原任务的提示词、图片、参考视频和参考音频。

<RequestExample>
  ```bash 按任务 ID 再生成 cURL theme={null}
  curl -X POST https://zx1.deepwl.net/v1/video/remix \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "MiniMax-H3",
      "task_id": "task_a1b2xxxxx5f6"
    }'
  ```
</RequestExample>

## Body

除以下字段外，其余字段（`prompt`、`duration`、`image`、`images`、`metadata.*`）与 [OpenAI 格式 2K 再生成](./remix) 相同。

<ParamField body="model" type="string" required>
  模型名称，当前仅支持 `MiniMax-H3`。
</ParamField>

<ParamField body="task_id" type="string">
  源视频的网关任务 ID，即创建接口返回的 `id`。与 `metadata.base_video` 二选一；网关会自动换算为上游任务 ID。
</ParamField>

## 响应示例

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "task_a1b2xxxxx5f6",
    "task_id": "task_a1b2xxxxx5f6",
    "object": "video",
    "model": "MiniMax-H3",
    "status": "queued",
    "progress": 0,
    "created_at": 1785125529
  }
  ```

  ```json 400 theme={null}
  {
    "code": "invalid_request",
    "message": "video_id in path or metadata.base_video is required for remix",
    "data": null
  }
  ```
</ResponseExample>

响应字段含义与 [2K 再生成（OpenAI 格式）](./remix) 一致。

## 错误码

| HTTP 状态码 | 说明                                      |
| -------- | --------------------------------------- |
| `400`    | 未提供有效源视频，或按 `base_video` 方式时缺少 `prompt` |
| `401`    | 鉴权失败                                    |
| `402`    | 额度不足                                    |
| `429`    | 触发限流                                    |
| `500`    | 服务端错误                                   |

## 相关接口

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