Create Video Regeneration Task

curl --request POST \
  --url https://api.minimax.io/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "Epic space-opera theatrical teaser: a female captain stands alone before a massive observation window as the last fleet gathers and jumps away in a blinding flash, the bridge shaking, leaving her behind."
    },
    {
      "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.minimax.io/v2/video_regeneration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "Epic space-opera theatrical teaser: a female captain stands alone before a massive observation window as the last fleet gathers and jumps away in a blinding flash, the bridge shaking, leaving her behind."
    },
    {
      "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"
}

This endpoint only regenerates videos that meet the MiniMax-H3 768P output specifications to produce 2K output. It is not a general-purpose video upscaling endpoint.

Regeneration tasks have task_type=regeneration and can be managed through the shared H3 Query Task, List Tasks, and Cancel or Delete Task endpoints.

Authorizations

Authorization

string

header

required

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key, used to verify account information, can be found in Account Management>API Keys.

Headers

Content-Type

enum<string>

default:application/json

required

Media type of the request body. Set it to application/json.

Available options:

application/json

Body

application/json

Video regeneration request.

model

enum<string>

required

Model name. Required. Currently supports MiniMax-H3.

Available options:

MiniMax-H3

content

object[]

required

Video regeneration input array. Include:

Submit exactly the same inputs that were actually sent to the model when generating the 768P source video. The text must be the final prompt actually sent to the model, not the original prompt from before H3-Context-IR processing. All reference images, videos, and audio must also match the original generation inputs. Any mismatch may prevent regeneration from producing the expected result
One 768P source-video item with type=video_url and role=base_video; exactly one such item is required

base_video must meet the following MiniMax-H3 768P output specifications. This endpoint does not upscale arbitrary videos.

Item	Specification
Audio track	Must be present; videos without an audio track are not supported
Frame rate	24 fps
Width / Height	Both must be divisible by 32
Area (W × H)	≤ 768 × 1344 (1,032,192 px)
Total frames	107–362 frames in increments of 17 (about 4–15 seconds)

Input media limits: the total request body must be ≤ 64 MB; use public URLs for large files and avoid Base64. Format and per-file size limits for reference images / videos / audio are the same as the Create Video Generation Task endpoint.

Show child attributes

resolution

enum<string>

required

Target resolution for video regeneration. Required. Currently supports 2K.

Available options:

2K

callback_url

string

Callback URL for task status changes. Optional. Same behavior as callback_url of the create video generation task endpoint.

aigc_watermark

boolean

default:false

Whether to add an AIGC label watermark to the generated video. Optional. Defaults to false.

Response

The create endpoint returns a task_id. Use this task_id with the Query Task endpoint to retrieve the task status and result.

Successful Query Task response example

{
  "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 of the task, used to query the task status and result later.

Create H3-Context-IR Task Text to Video

Using the API

Text

Video

Speech

Image

Music

File

Models

Create Video Regeneration Task

Authorizations

Headers

Body

Response