video

MiniMax H3 Max 480p reference-to-video - Create video

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

post/v1/ai/video/minimax-h3-max-r2v-480p

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/video/minimax-h3-max-r2v-480p
  • 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. Mention references as @Image1, @Image2, ... @Video1, @Video2, ... or @Audio1, @Audio2, ... matching their 1-indexed array order.

reference_imagesstring[]

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_videosstring[]

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_audiosstring[]

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.

durationinteger

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_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": "@Image1 walks slowly across a sunlit room, handheld camera",
  "reference_images": [
    "https://example.com/reference-1.jpg"
  ],
  "reference_videos": [
    "https://example.com/reference-1.mp4"
  ],
  "reference_audios": [
    "https://example.com/reference-voice.mp3"
  ],
  "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.