创建视频再生成任务

curl --request POST \
  --url https://api.minimaxi.com/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://your-cdn.example.com/h3-t2va-768p.mp4"
      },
      "role": "base_video"
    }
  ],
  "resolution": "2K"
}
'

{
  "task_id": "424010985738629"
}

{
  "type": "error",
  "error": {
    "type": "bad_request_error",
    "message": "invalid params, content must include a non-empty text item (prompt is required) (2013)",
    "http_code": "400"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "authorized_error",
    "message": "login fail: Please carry the API secret key in the 'Authorization' field of the request header (1004)",
    "http_code": "401"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "insufficient_balance_error",
    "message": "insufficient balance (1008)",
    "http_code": "402"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "unprocessable_entity_error",
    "message": "video description contains sensitive content (1026)",
    "http_code": "422"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "rate limit, please retry later (1002)",
    "http_code": "429"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "server_error",
    "message": "internal error (1000)",
    "http_code": "500"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

POST

video_regeneration

curl --request POST \
  --url https://api.minimaxi.com/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "史诗级太空歌剧院线预告：女舰长独自站在巨大观景窗前，最后一支舰队正在集结并跃迁离去，强光爆闪、舰桥震动，她被留在原地。"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://your-cdn.example.com/h3-t2va-768p.mp4"
      },
      "role": "base_video"
    }
  ],
  "resolution": "2K"
}
'

{
  "task_id": "424010985738629"
}

{
  "type": "error",
  "error": {
    "type": "bad_request_error",
    "message": "invalid params, content must include a non-empty text item (prompt is required) (2013)",
    "http_code": "400"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "authorized_error",
    "message": "login fail: Please carry the API secret key in the 'Authorization' field of the request header (1004)",
    "http_code": "401"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "insufficient_balance_error",
    "message": "insufficient balance (1008)",
    "http_code": "402"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "unprocessable_entity_error",
    "message": "video description contains sensitive content (1026)",
    "http_code": "422"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "rate limit, please retry later (1002)",
    "http_code": "429"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

{
  "type": "error",
  "error": {
    "type": "server_error",
    "message": "internal error (1000)",
    "http_code": "500"
  },
  "request_id": "021785229015510a2c883cf675b9804d"
}

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

再生成任务的 task_type 为 regeneration，可通过 H3 共用的查询任务、查询任务列表和取消或删除任务接口管理。

授权

Authorization

string

header

必填

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在账户管理>接口密钥中查看。

请求头

Content-Type

enum<string>

默认值:application/json

必填

请求体的媒介类型,请设置为 application/json。

可用选项:

application/json

请求体

application/json

视频再生成请求。

model

enum<string>

必填

模型名称，必填。当前支持 MiniMax-H3。

可用选项:

MiniMax-H3

content

object[]

必填

视频再生成输入内容数组。请在数组中包含：

必须原样提交生成 768P 源视频时实际送入模型的全部输入。其中，text 必须使用当时实际送入模型的最终 prompt，不可使用 H3-Context-IR 处理前的原始 prompt；所有参考图片、视频和音频也必须与生成时一致。任何输入不一致，都可能无法达到预期的再生成效果
一个 768P 源视频项，type=video_url 且 role=base_video；该项必须且只能有一个

base_video 必须符合以下 MiniMax-H3 768P 输出规格。本接口不支持其他视频的通用超分。

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

输入媒体限制：请求体总大小 ≤ 64 MB，大文件请用公网 URL，勿用 Base64。参考图片 / 视频 / 音频的格式、单文件大小等限制同创建视频生成任务。

Show child attributes

resolution

enum<string>

必填

视频再生成的目标分辨率，必填。当前支持 2K。

可用选项:

2K

callback_url

string

任务状态变更的回调 URL,可选。行为同创建视频生成任务的 callback_url。

aigc_watermark

boolean

默认值:false

是否为生成视频添加 AIGC 水印，可选，默认 false。

响应

创建成功后返回 task_id。使用该 task_id 调用查询任务接口获取任务状态与结果。

查询任务成功响应示例

{
  "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"
  }
}

task_id

string

任务 ID，用于后续查询任务状态与结果。

创建 H3-Context-IR 任务创建文生视频任务

API 指引

文本

视频

语音

图片

音乐

文件

模型

授权

请求头

请求体

响应