Skip to content

inference.minimax.h3.ref2vid.v1

View markdown

The inference.minimax.h3.ref2vid.v1 job generates a video from one or more reference media guided by a text prompt using MiniMax Hailuo 03.

{
"type": "inference.minimax.h3.ref2vid.v1",
"config": {
"prompt": "a red fox trotting through a snowy forest at golden hour",
"references": [
"reference.png"
]
}
}

Additional configuration:

  • content_moderation (boolean; default True)
  • resolution (string; one of 768P, 2K; default 768P)
  • aspect_ratio (string; one of 16:9, 4:3, 1:1, 3:4, 9:16, 21:9)
  • duration (integer; default 6)

This job type is also available under its partner alias inference.partner.minimax.h3.ref2vid.v1.

{
"type": "object",
"required": [
"type",
"config"
],
"additionalProperties": false,
"properties": {
"type": {
"type": "string"
},
"config": {
"type": "object",
"required": [
"prompt",
"references"
],
"additionalProperties": false,
"properties": {
"references": {
"type": "array",
"minItems": 1,
"maxItems": 15,
"items": {
"type": "string",
"format": "filename",
"example": "subject.png",
"description": "Filename of a reference file."
},
"description": "Reference files to feature in the video. The role of each reference is derived from its content type: images, videos, and audio become reference_image, reference_video, and reference_audio respectively. Up to 9 images (JPEG, PNG, WEBP, HEIC, or HEIF; 30MB each; 256-5760px per side; width/height ratio 0.4-2.5), 3 videos (MP4 or MOV with H.264/H.265; 50MB each; 2-15s each and 15s combined; same pixel and ratio bounds; 23.976-60 fps), and 3 audio files (WAV or MP3; 15MB each; 2-15s each and 15s combined); audio never on its own."
},
"prompt": {
"type": "string",
"minLength": 3,
"maxLength": 7000,
"default": "a dancing cat under moonlight",
"description": "Description of desired output."
},
"content_moderation": {
"type": "boolean",
"default": true,
"description": "Filter NSFW content using MiniMax's content moderation."
},
"resolution": {
"type": "string",
"enum": [
"768P",
"2K"
],
"default": "768P",
"description": "This controls the general quality level of the output. Exact width and height will vary depending on the aspect ratio of the input image."
},
"aspect_ratio": {
"type": "string",
"enum": [
"16:9",
"4:3",
"1:1",
"3:4",
"9:16",
"21:9"
],
"description": "Controls the approximate aspect ratio of the resulting video. When omitted, the aspect ratio derives from the reference files."
},
"duration": {
"type": "integer",
"minimum": 4,
"maximum": 15,
"default": 6,
"description": "Duration of the video in seconds."
}
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}