> ## Documentation Index > Fetch the complete documentation index at: https://docs.magnific.com/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax H3 Max 768p reference-to-video - Create video > Generate 768p video with MiniMax H3 Max, guided by reference images, videos and audios. Mention them in the prompt as @Image1, @Video1, @Audio1 and so on. At least one reference image or reference video is required, and all references together must not exceed 12 files. ## OpenAPI ````yaml post /v1/ai/video/minimax-h3-max-r2v-768p openapi: 3.0.0 info: description: >- The Magnific API is your gateway to a vast collection of high-quality digital resources for your applications and projects. As a leading platform, it offers a wide range of graphics, including vectors, photos, illustrations, icons, PSD templates, and more, all curated by talented designers from around the world. title: Magnific API version: 1.0.0 servers: - description: B2B API Production V1 url: https://api.magnific.com security: - magnificApiKey: [] paths: /v1/ai/video/minimax-h3-max-r2v-768p: post: tags: - video summary: MiniMax H3 Max 768p reference-to-video - Create video description: >- Generate 768p video with MiniMax H3 Max, guided by reference images, videos and audios. Mention them in the prompt as @Image1, @Video1, @Audio1 and so on. At least one reference image or reference video is required, and all references together must not exceed 12 files. operationId: create_video_minimax_h3_max_r2v_768p requestBody: content: application/json: schema: $ref: '#/components/schemas/minimax-h3-max-r2v-request' required: true responses: '200': $ref: '#/components/responses/task-detail-200-default-response' '400': $ref: '#/components/responses/400-bad-request' '401': $ref: '#/components/responses/401-unauthorized' '500': $ref: '#/components/responses/500-internal-server-error' '503': $ref: '#/components/responses/503-service-unavailable' components: schemas: minimax-h3-max-r2v-request: properties: webhook_url: description: >- URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status. format: uri type: string prompt: description: >- Text prompt describing the video to generate. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order. example: '@Image1 walks slowly across a sunlit room, handheld camera' maxLength: 50000 minLength: 1 type: string reference_images: description: >- Up to 9 reference images that steer the subject and style. Each item is a publicly accessible URL or a base64-encoded image. Reference them in the prompt using @Image1, @Image2, ... @Image9 (1-indexed to the array order). Reference images, videos and audios together must also not exceed 12 files. example: - https://example.com/reference-1.jpg items: format: byte type: string maxItems: 9 type: array reference_videos: description: >- Up to 3 reference videos that steer the motion. Each item must be a publicly accessible HTTPS URL or a video upload file_id (`upl_vid_...`). Reference them in the prompt using @Video1, @Video2 or @Video3. Each video must be 2 to 15 seconds and their combined duration must not exceed 15 seconds. Reference images, videos and audios together must also not exceed 12 files. example: - https://example.com/reference-1.mp4 items: type: string maxItems: 3 type: array reference_audios: description: >- Up to 3 reference audios. Each item must be a publicly accessible HTTPS URL — unlike `reference_videos`, this field does not take upload file_ids. Reference them in the prompt using @Audio1, @Audio2 or @Audio3. Each audio must be 2 to 15 seconds and their combined duration must not exceed 15 seconds. Audio cannot be the only reference: at least one `reference_images` or `reference_videos` entry is required alongside it. Reference images, videos and audios together must also not exceed 12 files. example: - https://example.com/reference-voice.mp3 items: type: string maxItems: 3 type: array duration: default: 5 description: Video duration in seconds. Any integer from 5 to 15. example: 5 maximum: 15 minimum: 5 type: integer aspect_ratio: default: adaptive description: | Output video aspect ratio. Available options: - `adaptive`: the model picks it from the reference assets - `film_horizontal_21_9`: Ultra-wide cinematic (21:9) - `widescreen_16_9`: Standard widescreen (16:9) - `classic_4_3`: Classic TV format (4:3) - `square_1_1`: Square format (1:1) - `traditional_3_4`: Portrait classic (3:4) - `social_story_9_16`: Vertical/social media story (9:16) enum: - adaptive - film_horizontal_21_9 - widescreen_16_9 - classic_4_3 - square_1_1 - traditional_3_4 - social_story_9_16 type: string prompt_expansion_mode: default: balanced description: >- Which prompt expander runs before the generation. `disabled` sends the prompt verbatim; `fast`, `balanced` and `quality` trade latency for richer prompt rewriting. enum: - disabled - fast - balanced - quality type: string enable_safety_checker: default: true description: >- Enable content safety filtering to ensure generated videos comply with safety guidelines. type: boolean seed: default: -1 description: >- Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed. maximum: 4294967295 minimum: -1 type: integer required: - prompt type: object inline_object_4: example: data: generated: - https://openapi-generator.tech - https://openapi-generator.tech task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: data: $ref: '#/components/schemas/task-detail_1' required: - data type: object inline_object: example: message: message properties: message: type: string type: object inline_object_1: properties: problem: $ref: '#/components/schemas/inline_object_1_problem' type: object inline_object_2: example: message: Internal Server Error properties: message: example: Internal Server Error type: string type: object inline_object_3: example: message: Service Unavailable. Please try again later. properties: message: example: Service Unavailable. Please try again later. type: string type: object task-detail_1: allOf: - $ref: '#/components/schemas/task' - properties: generated: items: description: URL of the generated image format: uri type: string type: array required: - generated type: object example: generated: - https://openapi-generator.tech - https://openapi-generator.tech task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED inline_object_1_problem: properties: message: example: Validation error type: string invalid_params: items: $ref: '#/components/schemas/inline_object_1_problem_invalid_params_inner' type: array required: - invalid_params - message type: object task: example: task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED properties: task_id: description: Task identifier format: uuid type: string status: description: Task status enum: - CREATED - IN_PROGRESS - COMPLETED - FAILED type: string required: - status - task_id type: object inline_object_1_problem_invalid_params_inner: properties: name: description: Name of the invalid parameter. example: page type: string field: description: Field of the invalid parameter. Mirrors `name`. example: page type: string reason: example: Parameter 'page' must be greater than 0 type: string required: - field - name - reason type: object responses: task-detail-200-default-response: content: application/json: examples: success - created task: $ref: '#/components/examples/200-task-created' success - in progress task: $ref: '#/components/examples/200-task-in-progress' success - completed task: $ref: '#/components/examples/200-task-completed' success - failed task: $ref: '#/components/examples/200-task-failed' schema: $ref: '#/components/schemas/inline_object_4' description: OK - The task exists and the status is returned 400-bad-request: content: application/json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Parameter 'page' must be greater than 0 invalid_query: summary: Parameter 'query' is not valid value: message: Parameter 'query' must not be empty invalid_filter: summary: Parameter 'filter' is not valid value: message: Parameter 'filter' is not valid generic_bad_request: summary: Bad Request value: message: Parameter ':attribute' is not valid schema: $ref: '#/components/schemas/inline_object' application/problem+json: examples: invalid_page: summary: Parameter 'page' is not valid value: message: Validation error invalid_params: - field: page reason: Parameter 'page' must be greater than 0 - field: per_page reason: Parameter 'per_page' must be greater than 0 schema: $ref: '#/components/schemas/inline_object_1' description: >- Bad Request - The server could not understand the request due to invalid syntax. 401-unauthorized: content: application/json: examples: invalid_api_key: summary: API key is not valid value: message: Invalid API key missing_api_key: summary: API key is not provided value: message: Missing API key schema: $ref: '#/components/schemas/inline_object' description: >- Unauthorized - The client must authenticate itself to get the requested response. 500-internal-server-error: content: application/json: schema: $ref: '#/components/schemas/inline_object_2' description: >- Internal Server Error - The server has encountered a situation it doesn't know how to handle. 503-service-unavailable: content: application/json: schema: $ref: '#/components/schemas/inline_object_3' description: Service Unavailable examples: 200-task-created: summary: Success - Task created value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: CREATED 200-task-in-progress: summary: Success - Task in progress value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: IN_PROGRESS 200-task-completed: summary: Success - Task completed value: data: generated: - https://ai-statics.freepik.com/completed_task_image.jpg task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: COMPLETED 200-task-failed: summary: Success - Task failed value: data: generated: [] task_id: 046b6c7f-0b8a-43b9-b35d-6489e6daee91 status: FAILED securitySchemes: magnificApiKey: description: > Your Magnific API key. Required for authentication. [Learn how to obtain an API key](https://docs.magnific.com/quickstart) in: header name: x-magnific-api-key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.