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",
  "source_task_id": "424010985738629",
  "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",
  "source_task_id": "424010985738629",
  "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"
}

Two methods are supported (choose one):

By task ID: pass an existing generation task’s source_task_id
By source video: pass base_video in content

This endpoint only regenerates videos that meet the MiniMax-H3 768P output specifications to produce 2K output. It does not perform general-purpose processing of arbitrary videos.

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

Regenerate by task ID (source_task_id)
Regenerate by source video (base_video)

model

enum<string>

required

Model name. Required. Currently supports MiniMax-H3.

Available options:

MiniMax-H3

source_task_id

string

required

The task_id of an existing succeeded /v2/video_generation task; its output is used as the source for regeneration. Constraints: requires whitelist access; the source task must be owned by the current account, in succeeded status, and still queryable via /v2/query/video_generation (created within 7 days).

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.

Using the API

Text

Video

Image

Speech

File

Models

Legacy APIs

Create Video Regeneration Task

Authorizations

Headers

Body

Response