> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Hailuo 2.3 I2V > [Core Function] Hailuo 2.3 I2V is a flagship image-to-video generation model optimized for character animation. [Strengths] It excels at animating human characters from a single image, maintaining consistent facial features, producing natural micro-expressions, and handling stylized artwork seamlessly. [Best For] Highly recommended for: animating character concept art, bringing portraits to life, and creating stylized/anime motion sequences. [Limitations] Do NOT use this model for last-frame conditioning (it does not support FL2V). Do NOT use if you need 1080p resolution for 10 seconds (1080p is capped at 6s). [Routing] Use this model by default for high-quality image-to-video tasks involving people or art. For physical realism or 10s at 1080p, route to Hailuo 02 I2V. For cost-effective/faster generation, route to Hailuo 2.3 Fast I2V. ## OpenAPI ````yaml /model-api/minimax/minimax-i2v.json post /minimax/hailuo-2.3-i2v openapi: 3.1.0 info: description: The image-to-video models API from MiniMax. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: MiniMax Image-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-video models API from MiniMax. security: - bearerAuth: [] paths: /minimax/hailuo-2.3-i2v: post: summary: Hailuo 2.3 I2V description: >- [Core Function] Hailuo 2.3 I2V is a flagship image-to-video generation model optimized for character animation. [Strengths] It excels at animating human characters from a single image, maintaining consistent facial features, producing natural micro-expressions, and handling stylized artwork seamlessly. [Best For] Highly recommended for: animating character concept art, bringing portraits to life, and creating stylized/anime motion sequences. [Limitations] Do NOT use this model for last-frame conditioning (it does not support FL2V). Do NOT use if you need 1080p resolution for 10 seconds (1080p is capped at 6s). [Routing] Use this model by default for high-quality image-to-video tasks involving people or art. For physical realism or 10s at 1080p, route to Hailuo 02 I2V. For cost-effective/faster generation, route to Hailuo 2.3 Fast I2V. operationId: minimaxHailuo23I2VAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MinimaxHailuo23I2VRequest' examples: basic: summary: Basic image-to-video value: first_frame_image: https://example.com/start-frame.jpg with_prompt: summary: With description and camera control value: first_frame_image: https://example.com/start-frame.jpg prompt: >- A bird takes off from the branch [Pedestal up], then flies away [Tracking shot] duration: 6 resolution: 1080P advanced: summary: Advanced with all parameters value: first_frame_image: https://example.com/start-frame.jpg prompt: >- The scene [Pan left,Pedestal up] reveals the landscape, camera [Push in] for close-up prompt_optimizer: true fast_pretreatment: true duration: 10 resolution: 768P responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-abc123 model_id: model-123 get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-abc123 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: MinimaxHailuo23I2VRequest: type: object required: - first_frame_image properties: prompt: type: string description: >- Video content description, supports Chinese and English. Supports 15 camera control instructions: [Truck left/right], [Pan left/right], [Push in/Pull out], [Pedestal up/down], [Tilt up/down], [Zoom in/out], [Shake], [Tracking shot], [Static shot]. Use combined commands like [Pan left,Pedestal up] or sequential commands minLength: 1 maxLength: 2000 example: >- A bird takes off from the branch [Pedestal up], then flies away [Tracking shot] first_frame_image: type: string description: >- First frame image URL or Base64 Data URL. Formats: JPG/JPEG/PNG/WebP. Size: <20MB. Dimensions: short side >300px, aspect ratio between 2:5 and 5:2 minLength: 1 example: https://example.com/start-frame.jpg prompt_optimizer: type: boolean description: Enable automatic prompt optimization to improve video quality default: true example: true fast_pretreatment: type: boolean description: >- Fast pretreatment mode (only effective when prompt_optimizer=true). Speeds up processing with slight quality trade-off default: false example: false duration: type: integer description: >- Video duration in seconds. Note: 10 seconds only supports 768P resolution default: 6 enum: - 6 - 10 example: 6 resolution: type: string description: >- Video resolution. Note: 10 seconds duration only supports 768P, 1080P only supports 6 seconds default: 768P enum: - 768P - 1080P example: 768P AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: 'Error message in format ''Category: detail''' example: 'Invalid parameters: parameter ''first_frame_image'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_first_frame: summary: Missing required first_frame_image value: code: 400 message: 'Invalid parameters: parameter ''first_frame_image'' is required' 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 invalid_image: summary: Invalid image format or size value: code: 400 message: >- Invalid parameters: image size exceeds 20MB or format not supported Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````