Token Switch 文档中心

中文

English

中文

English

Appearance

MiniMax-H3 创建视频再生成任务 ​

对符合 MiniMax-H3 768P 输出规格的源视频再生成 2K 视频。

接口地址 ​

http
POST /minimax/v2/video_regeneration

使用限制：

  • 仅支持对符合 MiniMax-H3 768P 输出规格的生成视频进行再生成并输出 2K，不支持任意视频的通用处理
  • 再生成任务的 task_type 为 regeneration，可通过 H3 共用的查询任务、查询任务列表接口管理

请求头 ​

参数名类型必填默认值说明
Content-Typestring是application/json请求体媒介类型
Authorizationstring是-鉴权信息，格式为 Bearer <API_KEY>

请求体（二选一） ​

支持两种方式：按任务 ID（source_task_id）或 按源视频（在 content 中传 role 为 base_video 的 video_url）。

两种方式互斥，同一请求中不能同时传 source_task_id 与 content.base_video。

方式一：按任务 ID 再生成 ​

参数名类型必填说明
modelstring是模型名称，当前支持 MiniMax/MiniMax-H3-Regeneration
source_task_idstring是已有 /v2/video_generation 成功任务的 task_id。限制：需开通白名单；源任务须属于当前账号、状态为 succeeded，且创建于 7 天内仍可查询
resolutionstring是目标分辨率，当前支持 2K
callback_urlstring否任务状态变更回调 URL，行为同创建视频生成任务
aigc_watermarkboolean否是否添加 AIGC 水印，默认 false

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

直接上传源视频地址作为再生成输入，无需依赖原任务 ID，也不受「源任务 7 天内可查」限制。

参数名类型必填说明
modelstring是模型名称，当前支持 MiniMax/MiniMax-H3-Regeneration
contentobject[]是多模态输入内容数组。必须包含一个非空 text 项和一个 role 为 base_video 的 video_url 项
resolutionstring是目标分辨率，当前支持 2K
callback_urlstring否任务状态变更回调 URL，行为同创建视频生成任务
aigc_watermarkboolean否是否添加 AIGC 水印，默认 false

content 元素说明（方式二） ​

元素 typerole必填说明
text-是再生成的文本提示词（prompt），必须非空；缺失或非空校验失败会返回 400（错误码 2013）
video_urlbase_video是待再生成的源视频，有且仅有 1 个
image_urlfirst_frame否图生视频场景的首帧图片
image_urllast_frame否图生视频场景的尾帧图片
image_urlreference_image否多模态参考场景的参考图片
video_urlreference_video否多模态参考场景的参考视频
audio_urlreference_audio否多模态参考场景的参考音频（音色 / 配音参考）

支持的输入组合：

场景组合方式
文生再生成text + base_video
图生再生成text + base_video + first_frame（可选再叠加 last_frame）
多模态参考再生成text + base_video + reference_image / reference_video / reference_audio 的组合

互斥规则：同 创建视频生成任务。base_video 可与 first_frame / last_frame 或 reference_* 之一共存，但 first_frame / last_frame 与 reference_image / reference_video / reference_audio 之间仍互斥。

base_video 源视频要求 ​

  • 必须是 MiniMax-H3 生成的 768P 规格视频产物，不支持任意来源视频的通用超分 / 重制
  • 需为可访问的公网 URL；也可先通过 文件上传接口 上传，再以 mm_file://{file_id} 形式在 url 字段中引用
  • 视频的容器格式、编码、大小、时长等限制与 创建视频生成任务 的 video_url 一致
  • 该方式不传 duration / ratio，输出分辨率固定为 2K，宽高比与时长跟随 base_video 源视频

请求示例 ​

bash
# 按任务 ID 再生成
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_regeneration \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax/MiniMax-H3-Regeneration",
    "source_task_id": "424010985738629",
    "resolution": "2K"
  }'
# 按源视频再生成（base_video）-文生
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax/MiniMax-H3-Regeneration",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://your-cdn.example.com/h3-t2va-768p.mp4"
      },
      "role": "base_video"
    }
  ],
  "resolution": "2K"
}
'
# 按源视频再生成（base_video）-图生
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax/MiniMax-H3-Regeneration",
  "content": [
    {
      "type": "text",
      "text": "Pull focus to the people in the background and add more steam to the ramen bowl."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
      },
      "role": "first_frame"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://your-cdn.example.com/h3-i2va-768p.mp4"
      },
      "role": "base_video"
    }
  ],
  "resolution": "2K"
}
'
# 按源视频再生成（base_video）-多模态参考
curl --request POST \
  --url https://neolink.com/api/minimax/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax/MiniMax-H3-Regeneration",
  "content": [
    {
      "type": "text",
      "text": "角色说话：Follow the wind, live free. Leave worries behind, enjoy the moment，音色参考音频1"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3"
      },
      "role": "reference_audio"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://your-cdn.example.com/h3-r2va-768p.mp4"
      },
      "role": "base_video"
    }
  ],
  "resolution": "2K"
}
'

成功响应（HTTP 200） ​

json
{
  "task_id": "424010985738629"
}
字段类型说明
task_idstring任务 ID，用于后续查询任务状态与结果

查询任务响应示例 ​

json
{
  "task": {
    "id": "424010985738631",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1785126000,
    "updated_at": 1785126300,
    "content": {
      "url": "https://your-cdn.example.com/h3-regenerated-2k-output.mp4"
    },
    "resolution": "2K",
    "duration": 5,
    "usage": {
      "total_seconds": 5,
      "input_seconds": 0,
      "output_seconds": 5,
      "input_image_count": 0
    },
    "ratio": "",
    "task_type": "regeneration",
    "modality": "video"
  }
}

错误响应 ​

HTTP 状态码错误类型错误码说明
400bad_request_error2013参数无效。按源视频再生成时，常见于 content 缺少非空 text 项或缺少 base_video
401authorized_error1004认证失败
402insufficient_balance_error1008余额不足
422unprocessable_entity_error1026视频描述包含敏感内容
429rate_limit_error1002速率限制，请稍后重试
500server_error1000内部错误