DataEyesAI
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
  1. MiniMax-H3 Video Generation
  • Documentation
    • Getting Started
      • Welcome to DataEyesAI
      • Quickstart
      • API Keys and Authentication
      • Base URL and SDKs
      • Models, Groups, and Pricing
    • Developer Tool Integration
      • Claude Code
      • Claude Code for VS Code
      • Codex
      • OpenClaw
      • OpenCode
      • Cline
      • Gemini CLI
      • Grok CLI
      • n8n
      • AutoClaw
      • Other tools
      • Claude Code 400 troubleshooting
    • AI Models API
      • 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
    • Search / Reader Product
      • Search & Reader
      • Web Search
      • Search and Read
      • Video Search
      • Web Reader
      • Document Parsing
      • Trending
      • Weather
      • All City ID
    • Advanced & System API
      • FAQ
      • System interface
        • API Key & Quota Query API
        • API Key Management API
      • API Reference​​
        • Error Codes
        • Rate Limits and Billing Rules
      • List models
        • Models
  • Terms & Policies
    • DataEyesAI API Terms of Service
    • DataEyesAI Legal Notice and Privacy Policy
    • DataEyesAI Paid Services Agreement
    • Automatic Renewal Service Rules
  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