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"
}MiniMax-H3
Create Video Regeneration Task
Regenerate a source video that meets the MiniMax-H3 768P output specifications into a 2K video.
POST
/
v2
/
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_videoincontent
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
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
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 name. Required. Currently supports MiniMax-H3.
Available options:
MiniMax-H3 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).
Target resolution for video regeneration. Required. Currently supports 2K.
Available options:
2K Callback URL for task status changes. Optional. Same behavior as callback_url of the create video generation task endpoint.
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" } }
ID of the task, used to query the task status and result later.
⌘I