> ## 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 Regeneration

> Regenerate a MiniMax-H3 768P video as 2K with `POST /v1/videos/{video_id}/remix`.

# MiniMax-H3 2K Regeneration

Regenerates a 768P video that matches the MiniMax-H3 output specification into 2K. This is not a general-purpose upscaler for arbitrary videos.

## Method and Path

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

## Source Video Passing Methods

| Method                   | Parameter                 | `prompt`                                                         |
| ------------------------ | ------------------------- | ---------------------------------------------------------------- |
| By task ID (recommended) | Path parameter `video_id` | Not required                                                     |
| By source video URL      | `metadata.base_video`     | Required, and must match the original generation request exactly |

When regenerating by source video URL, you must re-attach the original task's prompt, images, reference video, and reference audio verbatim. Regeneration by task ID requires an upstream whitelist and the source task must still be within the 7-day query window.

<RequestExample>
  ```bash Regenerate by task 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>
  The gateway task ID of the source video, i.e. the `id` returned by the create endpoint. The gateway converts it to the upstream task ID automatically.
</ParamField>

## Body

<ParamField body="model" type="string" required>
  Model name. Currently only `MiniMax-H3` is supported.
</ParamField>

<ParamField body="prompt" type="string">
  Required when regenerating via `metadata.base_video`, and must exactly match the final prompt used to generate the 768P source video.
</ParamField>

<ParamField body="duration" type="integer">
  Source video duration; should match the actual source duration.
</ParamField>

<ParamField body="image" type="string">
  The first-frame image of the original task. Required verbatim when using the `base_video` method and the original task was image-to-video.
</ParamField>

<ParamField body="images" type="array<string>">
  The image inputs of the original task. Must match the original request when using the `base_video` method.
</ParamField>

<ParamField body="metadata.base_video" type="string">
  768P source video URL. The source must contain an audio track, be 24 fps, have width and height both divisible by 32, an area ≤ 768×1344, and a total frame count of 107–362.
</ParamField>

<ParamField body="metadata.base_video_duration" type="integer">
  Source video duration, provided by the caller when regenerating by source video URL.
</ParamField>

<ParamField body="metadata.reference_video" type="string">
  The reference video used by the original task. Must match the original request when using the `base_video` method.
</ParamField>

<ParamField body="metadata.reference_audio" type="string">
  The reference audio used by the original task. Must match the original request when using the `base_video` method.
</ParamField>

<ParamField body="metadata.aigc_watermark" type="boolean" default="false">
  Whether to add an AIGC watermark.
</ParamField>

## Response Example

<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">
  Regeneration task ID.
</ResponseField>

<ResponseField name="task_id" type="string">
  Legacy task ID; same value as `id`.
</ResponseField>

<ResponseField name="object" type="string">
  Always `video`.
</ResponseField>

<ResponseField name="model" type="string">
  Model name used by the task.
</ResponseField>

<ResponseField name="status" type="string">
  Task status, initial value `queued`.
</ResponseField>

<ResponseField name="progress" type="integer">
  Task progress percentage.
</ResponseField>

<ResponseField name="created_at" type="integer">
  Creation time, Unix timestamp (seconds).
</ResponseField>

## Error Codes

| HTTP Status | Description                                                                            |
| ----------- | -------------------------------------------------------------------------------------- |
| `400`       | No valid source video provided, or `prompt` missing when using the `base_video` method |
| `401`       | Authentication failed                                                                  |
| `402`       | Insufficient quota                                                                     |
| `429`       | Rate limited                                                                           |
| `500`       | Server error                                                                           |

## Related Endpoints

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