Explore/MiniMax H3 Lite
Video

MiniMax H3 Lite

Animate a first frame, a last frame or both with MiniMax H3 Lite. Use a prompt to guide motion and create 4–15 second videos at 480P or 768P for affordable creative exploration.

View docs
import { config, higgsfield } from "@higgsfield/client/v2";config({  credentials: process.env.HF_CREDENTIALS,});const result = await higgsfield.subscribe(  "minimax/h3-lite/image-to-video",  {    input: {      "prompt": "A cinematic scene at sunset",      "duration": 5,      "image_url": "https://example.com/input.jpg",      "resolution": "768P",      "aspect_ratio": "16:9",      "aigc_watermark": false    },    withPolling: true,  },);console.log(result);

MiniMax H3 Lite uses the model ID minimax/h3-lite/image-to-video. Animate a first frame, a last frame or both with MiniMax H3 Lite. Use a prompt to guide motion and create 4–15 second videos at 480P or 768P for affordable creative exploration.

1. Calling the API

Send requests to https://api.higgsfield.ai/minimax/h3-lite/image-to-video with a JSON body matching the parameters below.

Install

Install an official server-side SDK. cURL needs no package.

npm install @higgsfield/client

Setup

Keep credentials in server-side environment variables. The SDKs accept the same KEY_ID:KEY_SECRET value under their documented variable names.

export HF_CREDENTIALS="YOUR_KEY_ID:YOUR_KEY_SECRET" # TypeScript export HF_KEY="YOUR_KEY_ID:YOUR_KEY_SECRET" # Python and cURL

Request parameters

ParameterTypeRequiredDefaultDescription
promptstringYes—Prompt. Minimum length: 1. Maximum length: 7000.
durationintegerNo5Duration. Minimum: 4. Maximum: 15.
image_urlstringConditional—First frame URL. Minimum length: 1.
resolutionstringNo"768P"Resolution. Options: 480P, 768P.
aspect_ratiostringNo"16:9"Aspect ratio. Options: auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
end_image_urlstringConditional—Last frame URL. Minimum length: 1.
aigc_watermarkbooleanNofalse

2. Authentication

The official SDKs read credentials from the server environment and send the required Authorization: Key KEY_ID:KEY_SECRET header.

API Key

Never expose the secret in browser-side code or commit it to source control. The TypeScript SDK is server-side only. For direct HTTP calls, use:

Authorization: Key $HF_KEY

3. Queue

subscribe submits the asynchronous request and waits for a terminal result. The TypeScript SDK polls automatically when withPolling: true; the Python SDK's synchronous subscribe call also waits. A completed request returns the generated file in the video field.

Submit and wait

Replace placeholder media URLs with accessible URLs for your own files.

import { config, higgsfield } from "@higgsfield/client/v2"; config({ credentials: process.env.HF_CREDENTIALS, baseURL: "https://api.higgsfield.ai", }); const result = await higgsfield.subscribe( "minimax/h3-lite/image-to-video", { input: { "prompt": "Slowly move the camera toward the subject while leaves sway in the breeze", "duration": 5, "resolution": "768P", "aspect_ratio": "16:9", "image_url": "https://example.com/reference.png" }, withPolling: true, }, ); console.log(result);

Custom polling

For direct HTTP integration, submit the request and poll the returned status_url using the same API credentials until it reaches a terminal status. Use the returned cancel_url to request cancellation while the request is still queued. See the request lifecycle guide for response states.

4. Using this model

Provide a non-empty prompt of at most 7,000 characters. duration is an integer from 4 to 15 seconds, including every whole-second value in that range; it defaults to 5. resolution accepts 480P or 768P and defaults to 768P.

Provide image_url for the first frame, end_image_url for the last frame, or both. At least one frame is required. Output framing adapts to the supplied keyframe.

Use the aspect_ratio values listed in the parameter table. Where offered, auto and adaptive derive framing from the input; text-only requests fall back to 16:9. aigc_watermark is fixed to false.

Use URLs accessible to the service. The documentation examples use placeholder media URLs; replace them with your own image or media URL before sending a request.

5. Pricing

ResolutionOutput video per second
480P$0.025
768P$0.04

The total price is output duration × the rate for the selected resolution. A 5-second video costs $0.125 at 480P or $0.20 at 768P. First and last frame images are included in that price.