inference.minimax.h3.chili.ref2vid.v0

The inference.minimax.h3.chili.ref2vid.v0 job generates a 24 fps video with synchronized stereo audio using uploaded references. Images guide subjects and style, videos guide motion, and audio guides voices and music.

Upload the references as job inputs and list their filenames in references, in the order you want them used. If references is omitted, all uploaded inputs are used in upload order. Include at least one image or video; audio cannot be used on its own.

{
    "type": "inference.minimax.h3.chili.ref2vid.v0",
    "config": {
        "prompt": "the subject walks through a sunlit park, birds chirping",
        "references": ["face.jpg", "profile.jpg"],
        "duration": 6
    }
}

You can upload up to 15 references, subject to these limits:

Reference	Maximum count	Supported formats	Maximum file size	Duration
Image	9	JPEG, PNG, WEBP, HEIC, HEIF	30 MB each	—
Video	3	MP4 or MOV with H.264/H.265	50 MB each	2–15 seconds each; 15 seconds combined
Audio	3	WAV or MP3	15 MB each	2–15 seconds each; 15 seconds combined

Images and video frames must be 256–5760 pixels per side, with a width-to-height ratio between 0.4 and 2.5. Video frame rates must be 23.976–60 fps. The combined duration limits apply separately to video references and audio references.

prompt is required and must contain 3–7000 characters. Describe both the visual scene and the sounds you want to hear.

duration accepts whole seconds from 4 to 15 and defaults to 6. The actual video may be slightly longer than requested: 4 seconds produces about 4.46 seconds, and 15 seconds produces about 15.08 seconds.

resolution supports only 768P, which is also the default. Exact output dimensions depend on the aspect ratio. seed accepts an integer from 0 to 2147483647 for reproducible generation; omit it to use a random seed.

aspect_ratio defaults to adaptive, which uses the supported ratio closest to the first image or video reference. To choose the output shape explicitly, set it to 16:9, 4:3, 1:1, 3:4, 9:16, or 21:9.

Schema

{
  "type": "object",
  "required": [
    "type",
    "config"
  ],
  "additionalProperties": false,
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "inference.minimax.h3.base.ref2vid.v0",
        "inference.minimax.h3.fast.ref2vid.v0",
        "inference.minimax.h3.base.ref2vid.v1",
        "inference.minimax.h3.fast.ref2vid.v1",
        "inference.minimax.h3.turbo.ref2vid.v0",
        "inference.minimax.h3.hyper.ref2vid.v0",
        "inference.minimax.h3.chili.ref2vid.v0"
      ]
    },
    "config": {
      "type": "object",
      "required": [
        "prompt"
      ],
      "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, in the order the model should read them. The role of each reference is derived from its content type: images, videos, and audio act as subject/style, motion, and voice/music references 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. Optional: with the field absent, every uploaded input is a reference, in upload order."
        },
        "prompt": {
          "type": "string",
          "minLength": 3,
          "maxLength": 7000,
          "default": "a dancing cat under moonlight",
          "description": "Description of the desired video and audio."
        },
        "duration": {
          "type": "integer",
          "minimum": 4,
          "maximum": 15,
          "default": 6,
          "description": "Duration of the video in seconds. Rounded up to the model's frame grid (4 s returns 4.46 s, 15 s returns 15.08 s)."
        },
        "aspect_ratio": {
          "type": "string",
          "enum": [
            "adaptive",
            "16:9",
            "4:3",
            "1:1",
            "3:4",
            "9:16",
            "21:9"
          ],
          "default": "adaptive",
          "description": "Controls the approximate aspect ratio of the resulting video. With \"adaptive\" (the default), the aspect ratio derives from the first visual reference (snapped to the nearest supported ratio); an explicit ratio overrides it."
        },
        "resolution": {
          "type": "string",
          "enum": [
            "768P"
          ],
          "default": "768P",
          "description": "Only 768P is supported: the canvas targets a 768px short edge with a 768x1344 pixel area cap and 32px rounding; exact width and height follow the aspect ratio of the first visual reference."
        },
        "seed": {
          "type": "integer",
          "minimum": 0,
          "maximum": 2147483647,
          "description": "Seed for reproducible generation. Random when omitted."
        }
      }
    }
  }
}