创建视频再生成任务

文档版本：v1.0.0 | 最后更新：2026-08-13
本平台已完整适配 MiniMax 视频生成 V2（MiniMax-H3）官方接口，请求与响应均为透传，参数语义与官方一致。

对符合 MiniMax-H3 768P 输出规格的源视频再生成为 2K 视频。本接口为异步接口，创建成功后返回 task_id，任务的 task_type 为 regeneration，可通过 H3 共用的查询任务、查询任务列表和取消或删除任务接口管理。

POST https://platform.shuyanai.com/hailuo/v2/video_regeneration

注意：本接口仅支持对符合 MiniMax-H3 768P 输出规格的生成视频进行再生成并输出 2K，不支持任意视频的通用处理。

支持两种输入模式，source_task_id 与 content（含 base_video）必须且只能提供其一（都提供或都不提供均返回参数错误）。请求体不含 duration 字段，输出时长继承源视频。

模式一：按任务 ID 再生成（source_task_id）

传入一个已有 /v2/video_generation 成功任务的 task_id，以其产物为源再生成，无需再传 content。

参数	类型	必填	默认值	说明
`model`	string (enum)	是	—	模型名称。当前可用值：`MiniMax-H3`
`source_task_id`	string	是	—	源任务 ID。使用限制：需开通白名单（如需使用请联系平台）；源任务须为本账号创建、状态为 `succeeded`，且创建于 7 天内
`resolution`	string (enum)	是	—	目标分辨率，当前固定 `2K`
`callback_url`	string	否	—	任务状态变更回调地址，行为同创建视频生成任务
`aigc_watermark`	boolean	否	`false`	是否添加 AIGC 标识水印

模式二：按源视频再生成（base_video）

在 content 中提供且仅提供一个 type=video_url、role=base_video 的源视频项，并原样附上生成该 768P 视频时的其余输入。

参数	类型	必填	默认值	说明
`model`	string (enum)	是	—	模型名称。当前可用值：`MiniMax-H3`
`content`	array	是	—	再生成输入数组（见下）
`resolution`	string (enum)	是	—	目标分辨率，当前固定 `2K`
`callback_url`	string	否	—	同上
`aigc_watermark`	boolean	否	`false`	同上

content 数组必须包含：

生成 768P 源视频时实际送入模型的全部输入。其中 text 必须使用当时实际送入模型的最终 prompt（若使用过 H3-Context-IR，应为增强后的提示词，不可使用处理前的原始 prompt；单个 text 最多 40000 字符）；所有参考图片、视频、音频也必须与生成时一致。任何输入不一致，都可能无法达到预期的再生成效果。

一个 768P 源视频项：type=video_url 且 role=base_video，必须且只能有一个。

其余媒体限制（图片 / 参考视频 / 参考音频的格式、大小等）同创建视频生成任务。

base_video 源视频规格

base_video 必须符合以下 MiniMax-H3 768P 输出规格：

项目	规格
音轨	需包含音轨，不支持无音轨视频
帧率	24 fps
宽 / 高	均需能被 32 整除
面积（宽 × 高）	≤ 768 × 1344（1,032,192 像素）
总帧数	107–362 帧，每档递增 17 帧（约 4–15 秒）

请求示例

按任务 ID 再生成：

按源视频再生成：

响应示例

{
  "task_id": "424010985738631"
}

字段	类型	说明
`task_id`	string	再生成任务 ID，用于查询任务获取状态与结果

计费说明

按源视频实际时长（usage.total_seconds）× 再生成单价计费，输入图片每任务前 5 张免费、超出按张计费。提交时按 5 秒预估预扣，任务完成后按实际时长多退少补，失败全额退还。详见概述 · 计费与结算。

02-创建视频再生成任务

创建视频再生成任务#

模式一：按任务 ID 再生成（source_task_id）#

模式二：按源视频再生成（base_video）#

base_video 源视频规格#

请求示例#

响应示例#