{"servers":[{"url":"https://api.modellix.ai/api/v1/minimax/hailuo-02-t2v"}],"post":{"description":"[Core Function] Hailuo 02 T2V is a text-to-video generation model optimized for physical realism. [Strengths] It excels at complex physics simulation, fluid dynamics, broad cinematic scenes, and natively rendering 1080p video up to 10 seconds without downscaling. [Best For] Highly recommended for: product commercials, high-speed sports action, nature documentaries, and sweeping landscapes. [Limitations] Do NOT use this model for highly stylized anime/art or nuanced human micro-expressions, where Hailuo 2.3 performs better. [Routing] Route to this model when the user requests '1080p for 10 seconds', complex physical action (like splashing water or crashes), or broad landscapes. For human characters and stylization, use Hailuo 2.3 T2V.","operationId":"minimaxHailuo02T2VAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Basic video generation","value":{"prompt":"A peaceful beach at sunset with gentle waves"}},"with_optimization":{"summary":"With prompt optimization","value":{"duration":10,"fast_pretreatment":false,"prompt":"Aerial view of a forest in autumn, camera slowly descending","prompt_optimizer":true,"resolution":"768P"}}},"schema":{"properties":{"duration":{"default":6,"description":"Video duration in seconds","enum":[6,10],"example":6,"type":"integer"},"fast_pretreatment":{"default":false,"description":"Fast pretreatment mode (only effective when prompt_optimizer=true)","example":false,"type":"boolean"},"prompt":{"description":"Video content description, supports Chinese and English","example":"A peaceful beach at sunset with gentle waves","maxLength":2000,"minLength":1,"type":"string"},"prompt_optimizer":{"default":true,"description":"Enable automatic prompt optimization","example":true,"type":"boolean"},"resolution":{"default":"768P","description":"Video resolution","enum":["768P","1080P"],"example":"768P","type":"string"}},"required":["prompt"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"},"400":{"content":{"application/json":{"examples":{"invalid_duration":{"summary":"Invalid duration value","value":{"code":400,"message":"Invalid parameters: duration must be one of [6, 10]"}},"invalid_resolution":{"summary":"Invalid resolution for duration","value":{"code":400,"message":"Invalid parameters: 10 seconds duration only supports 768P resolution"}},"missing_prompt":{"summary":"Missing required prompt","value":{"code":400,"message":"Invalid parameters: parameter 'prompt' is required"}}},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Invalid request parameters"},"401":{"content":{"application/json":{"example":{"code":401,"message":"Authentication failed: invalid API key"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Unauthorized - Invalid or missing API Key"},"429":{"content":{"application/json":{"example":{"code":429,"message":"Rate limit exceeded: 100 requests per minute, retry after 60 seconds"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Too many requests - Rate limit exceeded","headers":{"X-RateLimit-Limit":{"description":"Maximum requests per minute","schema":{"example":100,"type":"integer"}},"X-RateLimit-Remaining":{"description":"Remaining quota in current window","schema":{"example":0,"type":"integer"}},"X-RateLimit-Reset":{"description":"Rate limit window reset time (Unix timestamp)","schema":{"example":1704067260,"type":"integer"}}}},"500":{"content":{"application/json":{"example":{"code":500,"message":"Internal server error"},"schema":{"properties":{"code":{"description":"Error code (equals HTTP status code)","example":400,"type":"integer"},"message":{"description":"Error message in format 'Category: detail'","example":"Invalid parameters: parameter 'prompt' is required","type":"string"}},"required":["code","message"],"type":"object"}}},"description":"Internal server error"}},"summary":"Hailuo 02 T2V","x-mint":{"href":"minimax/hailuo-02-t2v"}}}