Hailuo · VIDEO

MiniMax H3 Reference to Video API

MiniMax H3 Reference to Video is a video workflow in the Sorceress catalog.

Catalog preview — Sorceress API activation pending

MiniMax H3 Reference to Video model artwork

Using MiniMax H3 Reference to Video in your workflow

Sorceress brings Hailuo models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

  • Explore motion and scene concepts.
  • Automate video generation with a saved job that your application can track.

Pricing and availability

Sorceress pricing is awaiting activation. The reference catalog lists 8 credits per second 768P, 13 2K; that reference is not a Sorceress quote. This entry cannot currently be invoked through Sorceress.

Inputs and supported options

{
  "type": "object",
  "required": [
    "prompt",
    "duration"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "maxLength": 7000,
      "minLength": 1,
      "description": "Video generation prompt, length is between 1 and 7000 characters."
    },
    "duration": {
      "enum": [
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "type": "integer",
      "title": "Duration",
      "default": 6,
      "maximum": 15,
      "minimum": 4,
      "description": "The duration of the generated video, supporting integer values from 4 to 15 seconds."
    },
    "resolution": {
      "enum": [
        "768P",
        "2K"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "2K",
      "description": "Video resolution."
    },
    "aspect_ratio": {
      "enum": [
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "title": "Aspect ratio",
      "default": "adaptive",
      "description": "Video aspect ratio. The default is adaptive, or a specific ratio can be specified."
    },
    "reference_audio_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference audio URLs",
      "x-media": "audio",
      "maxItems": 3,
      "description": "Array of reference audio URLs. Supports up to 3 audios. Supports WAV, MP3; a single file size cannot exceed 15 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference audios cannot exceed 15 seconds. reference_audio cannot be used alone, it must be accompanied by reference_image or reference_video."
    },
    "reference_image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference image URLs",
      "x-media": "image",
      "maxItems": 9,
      "description": "Array of reference image URLs. Supports up to 9 images. Publicly accessible HTTP(S) URL; supported image formats include JPG, JPEG, PNG, WEBP, HEIC, and HEIF; a single image size cannot exceed 30 MB; the side length of the image must be between 256 and 5760 pixels, and the aspect ratio must be between 0.4 and 2.5. Provide at least one of reference_image_urls or reference_video_urls."
    },
    "reference_video_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference video URLs",
      "x-media": "video",
      "maxItems": 3,
      "description": "Array of reference video URLs. Supports up to 3 videos. Supports MP4, MOV; video encoding supports H.264, H.265, audio encoding supports AAC, MP3; a single file size cannot exceed 50 MB; the duration of a single segment is 2 to 15 seconds, and the total duration of all reference videos cannot exceed 15 seconds; the video side length must be between 256 and 5760 pixels, the aspect ratio must be between 0.4 and 2.5, and the frame rate must be between 23.976 and 60. Provide at least one of reference_image_urls or reference_video_urls."
    }
  }
}

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.