---
title: "MiniMax H3 Max 768p reference-to-video - Create video"
method: POST
path: "/v1/ai/video/minimax-h3-max-r2v-768p"
tags: ["video"]
---

# MiniMax H3 Max 768p reference-to-video - Create video

`POST /v1/ai/video/minimax-h3-max-r2v-768p`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/video/minimax-h3-max-r2v-768p`
- Auth: API key in header `x-magnific-api-key`

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.

## Request body

- MinimaxH3MaxR2vRequest
  - `webhook_url` string, uri: URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.
  - `prompt` string, required: Text prompt describing the video to generate. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order.
  - `reference_images` string[]: 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.
  - `reference_videos` string[]: 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.
  - `reference_audios` string[]: 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.
  - `duration` integer: Video duration in seconds. Any integer from 5 to 15.
  - `aspect_ratio` 'adaptive' | 'film_horizontal_21_9' | 'widescreen_16_9' | 'classic_4_3' | 'square_1_1' | 'traditional_3_4' | 'social_story_9_16': 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)
  - `prompt_expansion_mode` 'disabled' | 'fast' | 'balanced' | 'quality': Which prompt expander runs before the generation. `disabled` sends the prompt verbatim; `fast`, `balanced` and `quality` trade latency for richer prompt rewriting.
  - `enable_safety_checker` boolean: Enable content safety filtering to ensure generated videos comply with safety guidelines.
  - `seed` integer: Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use `-1` for a random seed.

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)