> ## 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 H3 V2V > [Core Function] MiniMax H3 V2V generates video guided by one or more reference videos plus a text prompt. [Strengths] It accepts up to 3 reference videos with optional reference images and audios, 4-15 second duration, 768P or 2K output, and optional aspect ratio defaulting to 16:9. [Best For] Highly recommended for: motion remix, style transfer from video clips, keeping subject motion while changing the scene description, and multi-clip reference guidance. [Limitations] Do NOT use this model for text-only generation or first or last frame transitions. prompt, duration, resolution, and reference_videos are required. Do NOT send first_frame_image or last_frame_image on this endpoint. [Routing] Choose MiniMax H3 V2V when the user provides reference videos. For reference stills only, use MiniMax H3 I2V. For start or end frames, use MiniMax H3 FL2V. For text only, use MiniMax H3 T2V. ## OpenAPI ````yaml /media-model-api/minimax/minimax-v2v.json post /minimax/minimax-h3-v2v openapi: 3.1.0 info: description: The video-to-video models API from MiniMax. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: MiniMax Video-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The video-to-video models API from MiniMax. security: - bearerAuth: [] paths: /minimax/minimax-h3-v2v: post: summary: MiniMax H3 V2V description: >- [Core Function] MiniMax H3 V2V generates video guided by one or more reference videos plus a text prompt. [Strengths] It accepts up to 3 reference videos with optional reference images and audios, 4-15 second duration, 768P or 2K output, and optional aspect ratio defaulting to 16:9. [Best For] Highly recommended for: motion remix, style transfer from video clips, keeping subject motion while changing the scene description, and multi-clip reference guidance. [Limitations] Do NOT use this model for text-only generation or first or last frame transitions. prompt, duration, resolution, and reference_videos are required. Do NOT send first_frame_image or last_frame_image on this endpoint. [Routing] Choose MiniMax H3 V2V when the user provides reference videos. For reference stills only, use MiniMax H3 I2V. For start or end frames, use MiniMax H3 FL2V. For text only, use MiniMax H3 T2V. operationId: minimaxH3V2VAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MinimaxH3V2VRequest' examples: basic: summary: Reference video value: prompt: Remix the motion with cinematic lighting reference_videos: - https://example.com/ref.mp4 duration: 5 resolution: 2K responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: MinimaxH3V2VRequest: type: object required: - prompt - duration - resolution - reference_videos properties: prompt: type: string minLength: 1 maxLength: 7000 description: Video content description. reference_videos: type: array minItems: 1 maxItems: 3 description: Reference video URLs used to guide motion or content (1-3). items: type: string minLength: 1 reference_images: type: array maxItems: 9 description: Optional reference image URLs (up to 9). items: type: string minLength: 1 reference_audios: type: array maxItems: 3 description: Optional reference audio URLs (up to 3). items: type: string minLength: 1 duration: type: integer enum: - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - 13 - 14 - 15 default: 5 description: Required video duration in seconds. resolution: type: string enum: - 768P - 2K default: 2K description: Required output resolution. ratio: type: string enum: - '21:9' - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: '16:9' description: >- Optional video aspect ratio. One of the listed values. Default: 16:9. 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 ''prompt'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_prompt: summary: Missing required prompt value: code: 400 message: 'Invalid parameters: parameter ''prompt'' 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 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`.' ````