> ## 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. # MiniMax S2V-01 > [Core Function] MiniMax S2V-01 is a Subject-to-Video generation model. [Strengths] It excels at maintaining strict identity consistency of a specific subject (provided via reference images) while generating a video of that subject performing actions described in a text prompt. [Best For] Highly recommended for: character-consistent storytelling, generating multiple videos with the same actor, and brand mascot animation. [Limitations] Do NOT use this model if you just want to animate the provided image exactly as it is (use standard I2V). This model generates *new* scenes featuring the referenced subject. [Routing] Use this model when the user provides reference images of a character/subject and wants a video of them doing a specific new action based on a text prompt. ## OpenAPI ````yaml /model-api/minimax/minimax-i2v.json post /minimax/minimax-s2v-01 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/minimax-s2v-01: post: summary: MiniMax S2V-01 description: >- [Core Function] MiniMax S2V-01 is a Subject-to-Video generation model. [Strengths] It excels at maintaining strict identity consistency of a specific subject (provided via reference images) while generating a video of that subject performing actions described in a text prompt. [Best For] Highly recommended for: character-consistent storytelling, generating multiple videos with the same actor, and brand mascot animation. [Limitations] Do NOT use this model if you just want to animate the provided image exactly as it is (use standard I2V). This model generates *new* scenes featuring the referenced subject. [Routing] Use this model when the user provides reference images of a character/subject and wants a video of them doing a specific new action based on a text prompt. operationId: minimaxS2V01Async requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MinimaxS2V01Request' examples: basic: summary: Basic subject reference video value: subject_reference_images: - >- https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg prompt: A girl runs toward the camera and winks with a smile. with_prompt_optimizer: summary: With prompt optimizer enabled value: subject_reference_images: - https://example.com/character.jpg prompt: >- The character walks through a forest, looking around curiously. prompt_optimizer: true precise_control: summary: Precise control (optimizer disabled) value: subject_reference_images: - https://example.com/character.jpg prompt: Precise action description for exact control. prompt_optimizer: false base64_image: summary: Base64 encoded image value: subject_reference_images: - data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD... prompt: 动作描述 responses: '200': description: Successful response with task ID content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: success: true data: status: pending task_id: task-s2v-abc123 model_id: model-123 get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-s2v-abc123 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: MinimaxS2V01Request: type: object required: - subject_reference_images properties: prompt: type: string description: >- Video content description (optional). Describe the subject's actions, scenes, etc. Supports Chinese and English. Max 2000 characters. minLength: 1 maxLength: 2000 example: A girl runs toward the camera and winks with a smile. subject_reference_images: type: array description: >- Subject reference image URLs. Supports publicly accessible HTTP/HTTPS URLs or Base64 Data URLs. Used to maintain the appearance characteristics of the reference subject in the generated video. minItems: 1 maxItems: 10 items: type: string description: >- Image URL or Base64 Data URL. Image format: JPG/JPEG/PNG/WebP, <20MB, recommended short side >300px. minLength: 1 example: >- https://cdn.hailuoai.com/prod/2025-08-12-17/video_cover/1754990600020238321-411603868533342214-cover.jpg example: - https://example.com/character.jpg prompt_optimizer: type: boolean description: >- Whether to automatically optimize the prompt. Default is true. Set to false for more precise control. default: true example: true 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`.' ````