跳到主要内容

创建 H3 2K 升级任务

POST /v2/video_regeneration

将 H3 视频升级到 2K。请求体 model 必须是 MiniMax-H3；令牌和分组需要允许 MiniMax-H3-Regeneration 能力。使用平台 Bearer 模型密钥。

请求参数​

参数类型必选说明
modelstring是固定 MiniMax-H3，不支持 H3-Max
resolutionstring是固定 2K
source_task_idstring二选一当前用户、当前环境中创建未满 7 天且已成功的 H3 768P 平台任务 ID；不能是 H3-Max 或上游任务 ID
contentarray<object>二选一与 source_task_id 不能同时传；必须包含非空文本和恰好一个 role=base_video 的 video_url
ratiostring否content 模式下可指定允许的宽高比
callback_urlstring否客户终态通知地址，需先通过 challenge 校验

源任务升级会使用源任务的原渠道和提交时保存的上游连接。源任务仍须可用，当前令牌和分组仍须有升级权限；绑定其他渠道的令牌可能无法升级。若源任务缺少可用连接或结算用量，平台也可能拒绝升级。

方式一：通过平台源任务升级​

用真实的 H3 768P 成功任务 ID 替换示例值，不传 content。

{
  "model": "MiniMax-H3",
  "resolution": "2K",
  "source_task_id": "task_platform_source"
}

方式二：通过 base_video 升级​

用上游可访问的待升级视频地址替换示例 URL，不传 source_task_id。文本每项最多 40,000 个字符，其他媒体限制见接入指南。

{
  "model": "MiniMax-H3",
  "resolution": "2K",
  "content": [
    {"type": "text", "text": "保持原视频的主体和动作，提升画面清晰度"},
    {"type": "video_url", "role": "base_video", "video_url": {"url": "https://example.com/base-video.mp4"}}
  ]
}

响应（HTTP 200）​

{"task_id":"task_platform_upgrade"}

这是新的升级任务 ID。通过统一查询接口查询该 ID，成功结果为 task.content.url，task.task_type=regeneration。提交成功不代表升级完成。