{"servers":[{"url":"https://api.modellix.ai/api/v1/minimax/minimax-h3-max-t2v"}],"post":{"description":"[Core Function] MiniMax H3 Max T2V creates video from a text prompt only. [Strengths] It supports 5-15 second clips, 480P or 768P output, concrete aspect ratios from cinematic ultrawide to vertical, and optional prompt_expansion_mode (disabled, balanced, or quality). [Best For] Highly recommended for: prompt-only storyboards, character-driven shorts, cinematic B-roll from text, and drafts without image inputs. [Limitations] Do NOT use this model if you need to condition on images, first or last frames, or reference videos, or if you need 2K or a 4 second clip. prompt, duration, resolution, and ratio are required; ratio must be one of the documented aspect ratios. [Routing] Choose MiniMax H3 Max T2V for text-only MiniMax H3 Max video. If the user provides a start or end frame, use MiniMax H3 Max FL2V. If they provide reference images, use MiniMax H3 Max I2V. If they provide reference videos, use MiniMax H3 Max V2V. For 2K or 4 second clips, use MiniMax H3 T2V.","operationId":"minimaxH3MaxT2VAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Basic H3 Max T2V","value":{"duration":5,"prompt":"A boy playing basketball by the sea","ratio":"16:9","resolution":"768P"}}},"schema":{"properties":{"duration":{"default":5,"description":"Required video duration in seconds. 4 seconds is not supported.","enum":[5,6,7,8,9,10,11,12,13,14,15],"type":"integer"},"prompt":{"description":"Video content description.","maxLength":7000,"minLength":1,"type":"string"},"prompt_expansion_mode":{"default":"balanced","description":"Optional prompt expansion. disabled turns expansion off; balanced is the default; quality prioritizes expansion quality.","enum":["disabled","balanced","quality"],"type":"string"},"ratio":{"default":"16:9","description":"Required video aspect ratio. One of the listed values.","enum":["21:9","16:9","4:3","1:1","3:4","9:16"],"type":"string"},"resolution":{"default":"768P","description":"Required output resolution. 2K is not supported.","enum":["480P","768P"],"type":"string"}},"required":["prompt","duration","resolution","ratio"],"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":"MiniMax H3 Max T2V","x-mint":{"href":"minimax/minimax-h3-max-t2v"}}}