DataEyesAI
Official SiteConsoleDocs HomeGetting StartedDeveloper ToolsAI Models API
Terms & Policies
Official SiteConsoleDocs HomeGetting StartedDeveloper ToolsAI Models API
Terms & Policies
  1. MiniMax-H3 Video Generation
  • API Overview
  • Chat Completions
  • Responses
  • Messages (Claude)
  • Gemini (generateContent)
  • Embeddings
  • Image Models
    • Images
    • Gemini Image Generation
    • Grok Imagine Image
  • Midjourney format
    • Midjourney API Reference
    • Task query interface
    • Upload image
    • Get seed (Seed)
    • Submit Imagine task
    • Query tasks based on ID list
    • FaceSwap
    • Execute Action operation
    • /mj/submit/blend
    • Submit Describe task
    • Submit Modal
    • Refresh link
    • Edit image
    • Query task status by task ID
    • Get the seed of the task image
  • Video Model
    • FLUX Video Generation (flux-3-video)
    • Grok Video Generation
      • 00-Overview
      • 01-Text-to-Video
      • 02-Image-to-Video
      • 03-Reference-to-Video
      • 04-Video-Editing
      • 05-Video-Extension
    • Seedance Video Generation
      • 00-Overview
      • 01-Create-Video-Generation-Task
      • 02-Query-Video-Generation-Task
      • 03-Query-Video-Generation-Task-List
      • 04-Cancel-or-Delete-Task
      • Seedance Private Asset Library API Documentation
    • MiniMax-H3 Video Generation
      • 00-Overview
      • 01-Create-Video-Generation
      • 02-Create-Video-Regeneration
      • 03-Create-H3-Context-IR
      • 04-Query-Task
      • 05-List-Tasks
      • 06-Cancel-or-Delete-Task
    • Hailuo Video Generation
      • 00-Overview
      • 01-Text-to-Video-T2V
      • 02-Image-to-Video-I2V
      • 03-First-Last-Frame-FL2V
      • 04-Subject-Reference-S2V
      • 05-Query-Task-Status
      • 06-Video-Download
      • 99-Appendix-Camera-Movement-and-Webhooks
    • Jimeng Video Generation
      • 00-Overview
      • 01-3.0-Pro-Video-Generation
      • 02-720P-Text-to-Video
      • 03-720P-Image-to-Video-First-Frame
      • 04-720P-Image-to-Video-Start-End-Frame
      • 05-720P-Image-to-Video-Camera
      • 06-1080P-Text-to-Video
      • 07-1080P-Image-to-Video-First-Frame
      • 08-1080P-Image-to-Video-Start-End-Frame
      • 09-Error-Codes
    • Kling AI Video Generation
      • 00-Overview
      • 01-Text-to-Video
      • 02-Image-to-Video
      • 03-Omni-Video
      • 04-Multi-Image-to-Video
      • 05-Motion-Control
      • 06-Multi-Elements
      • 07-Video-Extension
      • 08-Lip-Sync
      • 09-Avatar
      • 10-Text-to-Audio
      • 11-Video-to-Audio
      • 12-TTS
      • 13-Custom-Voices
      • 14-Image-Recognition
      • 15-Element-Management
      • 16-Video-Effects
      • 17-Kling-4.0-Video-Generation
    • Vidu Video Generation
      • 00-Overview
      • 01-Text-to-Video
      • 02-Image-to-Video
      • 03-Reference-to-Video
      • 04-Start-End-Frame
      • 05-Multi-Frame
      • 06-Scene-Template
      • 07-Template-Story
      • 08-Query-Tasks
    • HappyHorse
      • HappyHorse Text-to-Video
      • HappyHorse Image-to-Video (First Frame)
      • HappyHorse Reference-to-Video
      • HappyHorse Video Editing
    • Wan Video Generation
      • 00-Overview.md
      • 01-Text-to-Video
      • 02-Image-to-Video
      • 03-Reference-to-Video
      • 04-Video-Editing
      • 05-First-Last-Frame-to-Video
      • 06-Motion-Transfer-and-Character-Swap
      • 07-Digital-Human-Video
      • 08-VACE-Video-Editing
      • 09-Query-Task
  • Audio API
    • Audio API
    • Gemini TTS API
    • Google DeepMind Lyria API
    • Elevenlabs Speech to Text API Reference
  1. MiniMax-H3 Video Generation

00-Overview

MiniMax-H3 Video Generation (V2) - Overview#

Version: v1.0.0 | Last Updated: 2026-08-13
This platform fully supports the MiniMax Video Generation V2 (MiniMax-H3) official API. Requests and responses are transparently proxied, and all parameter semantics remain consistent with the official API.

Capabilities#

MiniMax-H3 is MiniMax's next-generation video model. Tasks are created with a multimodal content array (text / image / video / audio), support 768P / 2K native output and 4-15 second durations, and come with two companion capabilities: 768P-to-2K regeneration and H3-Context-IR prompt enhancement.
CapabilityDocumentationDescription
Video Generation01-Create-Video-GenerationText-to-video, image-to-video (first / last / first+last frame), multimodal-reference-to-video
Video Regeneration02-Create-Video-RegenerationRegenerate an H3 768P source video into 2K
H3-Context-IR03-Create-H3-Context-IRUnderstand multimodal context and return a structured, enhanced prompt (no video is generated)
Relationship to Hailuo V1: MiniMax-H3 uses a standalone V2 API (route prefix /hailuo/v2/*). Its request / response structures are completely different from the Hailuo V1 API (/hailuo/v1/*); do not mix them.

Endpoints#

EndpointMethodURL
Create Video Generation TaskPOSThttps://studio.dataeyes.ai/hailuo/v2/video_generation
Create Video Regeneration TaskPOSThttps://studio.dataeyes.ai/hailuo/v2/video_regeneration
Create H3-Context-IR TaskPOSThttps://studio.dataeyes.ai/hailuo/v2/h3_context_ir
Query TaskGEThttps://studio.dataeyes.ai/hailuo/v2/query/video_generation/{task_id}
List TasksGEThttps://studio.dataeyes.ai/hailuo/v2/query/video_generation
Cancel or Delete TaskDELETEhttps://studio.dataeyes.ai/hailuo/v2/video_generation/{task_id}
URL Pattern: Append the channel prefix /hailuo after the platform domain, followed by the official V2 API path.
For example, the official https://api.minimaxi.com/v2/video_generation maps to https://studio.dataeyes.ai/hailuo/v2/video_generation.

Standard Workflow#

Create Task (POST /hailuo/v2/video_generation | video_regeneration | h3_context_ir)
        │  Returns task_id
        ▼
Query Task (GET /hailuo/v2/query/video_generation/{task_id})   ← Poll until succeeded
        │  Returns content.url (video tasks) or content.prompt (Context-IR tasks)
        ▼
Download / persist the output (download URLs are time-limited — save promptly)

Authentication#

All requests require a Bearer token in the HTTP Authorization header:
Authorization: Bearer {API_KEY}
{API_KEY} is the API key created in the DataEyes console.

Request Headers#

HeaderRequiredDescription
AuthorizationYesBearer {API_KEY}
Content-TypeYesMust be application/json (for task creation endpoints)

Task Status#

StatusDescription
queuedWaiting in queue; can be cancelled
runningProcessing
succeededCompleted; output available in content
failedFailed; the error field contains the code and reason
cancelledCancelled

Billing & Settlement#

Billing dimensions:
ItemHow it is billed
Video generation (768P / 2K, unit price by resolution)Per second, based on usage.total_seconds (input reference video seconds + output seconds, same rate)
Video regeneration (always 2K)Per second, based on the source video's actual duration (usage.total_seconds)
Extra input imagesFirst 5 images per task are free; additional images are billed per image
H3-Context-IRPer token: input billed on usage.prompt_tokens, output on usage.completion_tokens
Settlement:
Video generation / regeneration: an estimated output fee is pre-charged at submission (generation uses the requested duration; regeneration uses a 5-second estimate). After the task succeeds, the fee is settled against the actual usage returned by the query endpoint — the difference is charged or refunded accordingly.
H3-Context-IR: nothing is charged at submission; token usage is settled after the task succeeds.
Failed tasks: not billed; any pre-charged amount is fully refunded.
Cancelling a queued task: the pre-charged amount is refunded. Deleting a completed task does not affect settled charges.
For unit prices, please refer to the platform pricing page and your commercial agreement.

Error Responses#

On error, the HTTP status code is the real error code, and the response body follows an OpenAI-style structure:
{
  "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"
}
The number in parentheses at the end of error.message is the internal error code. Common errors:
HTTPerror.typeInternal CodeDescription
400bad_request_error2013Invalid parameters (e.g. content missing a non-empty text item)
401authorized_error1004 / 2049Authentication failed / invalid API key
402insufficient_balance_error1008Insufficient balance or quota
422unprocessable_entity_error1026Input contains sensitive content
429rate_limit_error1002Rate limited; retry later
500server_error1000Server error

Related Documentation#

04-Query-Task · 05-List-Tasks · 06-Cancel-or-Delete-Task
Previous
Seedance Private Asset Library API Documentation
Next
01-Create-Video-Generation