Create H3 2K Upgrade
POST /v2/video_regeneration
Upgrade an H3 video to 2K. The request model must remain MiniMax-H3; the token and group must allow MiniMax-H3-Regeneration. Authenticate with a platform Bearer model API key.
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Fixed MiniMax-H3; H3-Max is unsupported |
resolution | string | Yes | Fixed 2K |
source_task_id | string | One of two | Successful H3 768P platform task owned by the current user, in the current environment, created less than 7 days ago; not an H3-Max or upstream ID |
content | array<object> | One of two | Mutually exclusive with source_task_id; requires non-empty text and exactly one video_url with role=base_video |
ratio | string | No | For content-based input, optionally use an allowed aspect ratio |
callback_url | string | No | Customer terminal notification URL; must pass challenge verification |
A source-task upgrade uses the source channel and its saved upstream connection. The source must remain usable, and the current token and group must still have upgrade permission. A token bound to another channel may be rejected. Missing source connection or settlement usage can also prevent an upgrade.
Option 1: Upgrade by platform source task
Replace the example ID with an actual successful H3 768P task ID. Omit content.
{
"model": "MiniMax-H3",
"resolution": "2K",
"source_task_id": "task_platform_source"
}
Option 2: Upgrade by base_video
Replace the URL with an upstream-accessible source video. Omit source_task_id. Each text item allows up to 40,000 characters; see the integration guide for other media limits.
{
"model": "MiniMax-H3",
"resolution": "2K",
"content": [
{"type": "text", "text": "Preserve the subject and motion while improving video clarity"},
{"type": "video_url", "role": "base_video", "video_url": {"url": "https://example.com/base-video.mp4"}}
]
}
Response (HTTP 200)
{"task_id":"task_platform_upgrade"}
This is a new upgrade task ID. Use the shared query endpoint with this ID. Successful output is in task.content.url with task.task_type=regeneration. Submission does not mean completion.