inference.minimax.h3.base.img2vid.v1

The inference.minimax.h3.base.img2vid.v1 job animates a provided keyframe into a video with synchronized stereo audio (24 fps, canvas following the keyframe’s aspect ratio) using the MiniMax H3 (Hailuo-03) model. The base tier is the highest-quality option.

Upload the keyframe as a job input and reference its filename with first_frame; an optional last_frame pins the closing frame too. Naming is optional: with the fields absent, the first uploaded input is the first frame and a second upload, when present, the last frame:

{
    "type": "inference.minimax.h3.base.img2vid.v1",
    "config": {
        "prompt": "the scene comes to life, camera slowly pushing in",
        "first_frame": "input.jpg",
        "duration": 8
    }
}

duration, resolution and seed behave as in txt2vid (whole seconds 4–15, rounded up to the 17n+5 frame grid; outputs run 4.46–15.08 s; only the default 768P resolution is valid).

Schema

{
  "type": "object",
  "required": [
    "type",
    "config"
  ],
  "additionalProperties": false,
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "inference.minimax.h3.base.img2vid.v0",
        "inference.minimax.h3.fast.img2vid.v0",
        "inference.minimax.h3.base.img2vid.v1",
        "inference.minimax.h3.fast.img2vid.v1"
      ]
    },
    "config": {
      "type": "object",
      "required": [
        "prompt"
      ],
      "additionalProperties": false,
      "properties": {
        "first_frame": {
          "type": "string",
          "format": "filename",
          "example": "first_frame.png",
          "description": "Set the starting frame for the video. Optional: defaults to the first uploaded input."
        },
        "last_frame": {
          "type": "string",
          "format": "filename",
          "example": "last_frame.png",
          "description": "Set the ending frame for the video. Optional: defaults to the second uploaded input, when present."
        },
        "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)."
        },
        "resolution": {
          "type": "string",
          "enum": [
            "768P"
          ],
          "default": "768P",
          "description": "Only 768P is supported: the video is generated at a 768px short edge; exact width and height follow the aspect ratio of the input image."
        },
        "seed": {
          "type": "integer",
          "minimum": 0,
          "maximum": 2147483647,
          "description": "Seed for reproducible generation. Random when omitted."
        }
      }
    }
  }
}