> ## 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/videos/{video_id}/remix` 将 MiniMax-H3 的 768P 视频再生成为 2K。

# MiniMax-H3 2K 再生成

将符合 MiniMax-H3 输出规格的 768P 视频再生成为 2K。该接口不是任意视频的通用放大接口。

## 方法与路径

```http theme={null}
POST /v1/videos/{video_id}/remix
```

## 源视频传参方式

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

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

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

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6/remix",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={"model": "MiniMax-H3"},
      timeout=60,
  )
  print(resp.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://zx1.deepwl.net/v1/videos/task_a1b2xxxxx5f6/remix",
    {
      method: "POST",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ model: "MiniMax-H3" }),
    },
  );

  console.log(await response.json());
  ```
</RequestExample>

## Path Parameters

<ParamField path="video_id" type="string" required>
  源视频的网关任务 ID，即创建接口返回的 `id`。网关会自动换算为上游任务 ID。
</ParamField>

## Body

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

<ParamField body="prompt" type="string">
  按 `metadata.base_video` 再生成时必填，且必须与生成 768P 源视频时的最终提示词完全一致。
</ParamField>

<ParamField body="duration" type="integer">
  源视频时长，应与源视频实际时长一致。
</ParamField>

<ParamField body="image" type="string">
  原任务的首帧图片。按 `base_video` 方式且原任务为图生视频时必须原样传入。
</ParamField>

<ParamField body="images" type="array<string>">
  原任务的图片输入。按 `base_video` 方式时必须与原始请求一致。
</ParamField>

<ParamField body="metadata.base_video" type="string">
  768P 源视频地址。源视频须含音轨、为 24 fps、宽高均可被 32 整除、面积不超过 768×1344，总帧数为 107～362。
</ParamField>

<ParamField body="metadata.base_video_duration" type="integer">
  源视频时长，按源视频 URL 再生成时由调用方传入。
</ParamField>

<ParamField body="metadata.reference_video" type="string">
  原任务使用的参考视频。按 `base_video` 方式时必须与原始请求一致。
</ParamField>

<ParamField body="metadata.reference_audio" type="string">
  原任务使用的参考音频。按 `base_video` 方式时必须与原始请求一致。
</ParamField>

<ParamField body="metadata.aigc_watermark" type="boolean" default="false">
  是否添加 AIGC 标识水印。
</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>

## Response

<ResponseField name="id" type="string">
  再生成任务 ID。
</ResponseField>

<ResponseField name="task_id" type="string">
  兼容旧接口的任务 ID，值与 `id` 相同。
</ResponseField>

<ResponseField name="object" type="string">
  固定为 `video`。
</ResponseField>

<ResponseField name="model" type="string">
  任务使用的模型名称。
</ResponseField>

<ResponseField name="status" type="string">
  任务状态，初始值为 `queued`。
</ResponseField>

<ResponseField name="progress" type="integer">
  任务进度百分比。
</ResponseField>

<ResponseField name="created_at" type="integer">
  创建时间，Unix 时间戳（秒）。
</ResponseField>

## 错误码

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

## 相关接口

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