video

MiniMax H3 Max 768p - Create video

Generate 768p 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-768p.

post/v1/ai/video/minimax-h3-max-768p

Request

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

Request body

webhook_urlstring uri

URL to receive a webhook notification when the video generation task completes. The webhook payload includes the task ID and status.

promptstring required

Text prompt describing the video to generate.

imagestring 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_endstring 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.

durationinteger

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_checkerboolean

Enable content safety filtering to ensure generated videos comply with safety guidelines.

seedinteger

Random seed for reproducible video generation. Use the same seed with the same prompt to get consistent results. Use -1 for a random seed.

Example request

{
  "prompt": "A cinematic shot of a cat walking through a neon-lit alley at night",
  "duration": 5
}

Response

OK - The task exists and the status is returned

Example response

{
  "data": {
    "generated": [
      "https://openapi-generator.tech",
      "https://openapi-generator.tech"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.