{"servers":[{"url":"https://api.modellix.ai/api/v1/minimax/minimax-h3-i2v"}],"post":{"description":"[Core Function] MiniMax H3 I2V generates video from reference images plus a text prompt. [Strengths] It accepts up to 9 reference images and optional reference audios, with 4-15 second duration, 768P or 2K output, and optional aspect ratio defaulting to 16:9. [Best For] Highly recommended for: character or style consistency from stills, product look references, multi-image subject guidance, and prompt-driven scenes featuring a referenced subject. [Limitations] Do NOT use this model for first or last frame transitions or when the primary input is a reference video. prompt, duration, resolution, and reference_images are required. Do NOT send first_frame_image, last_frame_image, or reference_videos on this endpoint. [Routing] Choose MiniMax H3 I2V when the user provides reference stills. For start or end frames, use MiniMax H3 FL2V. For reference videos, use MiniMax H3 V2V. For text only, use MiniMax H3 T2V.","operationId":"minimaxH3I2VAsync","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Reference images","value":{"duration":5,"prompt":"Character speaks: Follow the wind, live free.","reference_images":["https://example.com/ref1.png"],"resolution":"2K"}}},"schema":{"properties":{"duration":{"default":5,"description":"Required video duration in seconds.","enum":[4,5,6,7,8,9,10,11,12,13,14,15],"type":"integer"},"prompt":{"description":"Video content description.","maxLength":7000,"minLength":1,"type":"string"},"ratio":{"default":"16:9","description":"Optional video aspect ratio. One of the listed values. Default: 16:9.","enum":["21:9","16:9","4:3","1:1","3:4","9:16"],"type":"string"},"reference_audios":{"description":"Optional reference audio URLs (up to 3).","items":{"minLength":1,"type":"string"},"maxItems":3,"type":"array"},"reference_images":{"description":"Reference image URLs used to guide subject or style (1-9).","items":{"minLength":1,"type":"string"},"maxItems":9,"minItems":1,"type":"array"},"resolution":{"default":"2K","description":"Required output resolution.","enum":["768P","2K"],"type":"string"}},"required":["prompt","duration","resolution","reference_images"],"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_image":{"summary":"Invalid image format or size","value":{"code":400,"message":"Invalid parameters: image size exceeds 20MB or format not supported"}},"invalid_resolution":{"summary":"Invalid resolution for duration","value":{"code":400,"message":"Invalid parameters: 10 seconds duration only supports 768P resolution"}},"missing_first_frame":{"summary":"Missing first and last frame","value":{"code":400,"message":"Invalid parameters: at least one of first_frame_image or last_frame_image 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 I2V","x-mint":{"href":"minimax/minimax-h3-i2v"}}}