MiniMax H3 — Reference to video API

← MiniMax H3 Endpoint: POST https://api.higgsfield.ai/minimax/h3/reference-to-video Endpoint ID: minimax/h3/reference-to-video ▶Open API PlaygroundMiniMax H3 · Reference to video↗

Usage notes

Resolution is fixed to the case-sensitive schema value “2K”. The prompt must contain non-whitespace text; the current provider serializer uses only its first 7,000 characters.
Provide at least one image or video reference. Audio references require an image or video reference and cannot be used alone.
Reference media may be cropped, resized, transcoded and trimmed. Video duration and audio duration are each normalized to fit within the provider’s 15-second total budget.

Quick start

Replace the example media URLs with publicly accessible URLs for your own files before submitting.

curl --request POST \
  --url https://api.higgsfield.ai/minimax/h3/reference-to-video \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A cinematic wide shot of ocean waves at sunset, with gentle camera movement.",
  "image_urls": [
    "https://example.com/input.jpg"
  ]
}'

import higgsfield_client

arguments = (
    {'prompt': 'A cinematic wide shot of ocean waves at sunset, with gentle camera '
               'movement.',
     'image_urls': ['https://example.com/input.jpg']}
)
result = higgsfield_client.subscribe(
    "minimax/h3/reference-to-video",
    arguments=arguments,
)
print(result["video"]["url"])

import { config, higgsfield } from "@higgsfield/client/v2";

config({ credentials: process.env.HF_CREDENTIALS });

const result = await higgsfield.subscribe("minimax/h3/reference-to-video", {
  input:
    {
      "prompt": "A cinematic wide shot of ocean waves at sunset, with gentle camera movement.",
      "image_urls": [
        "https://example.com/input.jpg"
      ]
    },
  withPolling: true,
});

if (result.status === "completed") {
  console.log(result.video?.url);
}

Input schema

string

required

Write your prompt here Minimum characters: 1.

integer

default:"5"

Requested output duration in seconds. Minimum: 5. Maximum: 15.

array

Ordered public audio reference URLs. Minimum items: 0. Maximum items: 3. Each item: string. Format: uri.

array

Ordered public image reference URLs. Minimum items: 1. Maximum items: 9. Each item: string. Format: uri.

string

default:"2K"

Output resolution tier. Allowed values: "2K".

array

Ordered public video reference URLs. Minimum items: 1. Maximum items: 3. Each item: string. Format: uri.

string

default:"auto"

Output width-to-height ratio. Allowed values: "auto", "adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16".

boolean

default:"false"

See the complete JSON schema below.

Complete JSON schema

{
  "if": {
    "required": [
      "image_urls"
    ]
  },
  "else": {
    "required": [
      "video_urls"
    ]
  },
  "type": "object",
  "title": "MiniMax H3 Reference to Video Playground",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "minLength": 1,
      "description": "Write your prompt here"
    },
    "duration": {
      "type": "integer",
      "title": "Duration",
      "default": 5,
      "maximum": 15,
      "minimum": 5
    },
    "audio_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference audio URLs",
      "maxItems": 3,
      "minItems": 0
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference image URLs",
      "maxItems": 9,
      "minItems": 1
    },
    "resolution": {
      "enum": [
        "2K"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "2K"
    },
    "video_urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "title": "Reference video URLs",
      "maxItems": 3,
      "minItems": 1
    },
    "aspect_ratio": {
      "enum": [
        "auto",
        "adaptive",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "title": "Aspect ratio",
      "default": "auto"
    },
    "aigc_watermark": {
      "type": "boolean",
      "title": "AIGC watermark",
      "default": false
    }
  },
  "additionalProperties": false
}

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.

Accepted

{
  "status": "queued",
  "request_id": "REQUEST_ID",
  "status_url": "https://api.higgsfield.ai/requests/REQUEST_ID/status",
  "cancel_url": "https://api.higgsfield.ai/requests/REQUEST_ID/cancel"
}

A completed response includes the following output fields:

{
  "status": "completed",
  "request_id": "REQUEST_ID",
  "video": {
    "url": "https://example.com/output.mp4"
  }
}

See polling, request errors and authentication for shared request handling.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

MiniMax H3 — Reference to video API

Usage notes

Quick start

Input schema

Response

​Usage notes

​Quick start

​Input schema

​Response

Usage notes

Quick start

Input schema

Response