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

# MiniMax H3 Max 480p - Create video

`POST /v1/ai/video/minimax-h3-max-480p`

## Request

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

Generate 480p video with MiniMax H3 Max, the optimised H3 build. Supports text-to-video and image-to-video with an optional first and last frame. For reference-guided generation use `/ai/video/minimax-h3-max-r2v-480p`.

## Request body

- MinimaxH3MaxRequest
  - `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.
  - `image` string, byte: Optional image to use as the first frame for image-to-video generation. Its aspect ratio determines the aspect ratio of the output. Accepts a publicly accessible URL or a base64-encoded image.
  - `image_end` string, byte: Optional image to use as the last frame for image-to-video generation. Requires `image`: the provider rejects a last frame with no first frame. Accepts a publicly accessible URL or a base64-encoded image.
  - `duration` integer: Video duration in seconds. Any integer from 5 to 15.
  - `aspect_ratio` '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: - `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) **Note:** only applies to text-to-video requests. When `image` is supplied the output follows the aspect ratio of that image.
  - `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)