MiniMax H3 Highspeed uses the model ID minimax/h3-highspeed/text-to-video. Generate 4–15 second videos from text with MiniMax H3 Highspeed. Choose 480P or 768P and control the scene, motion and aspect ratio for quick creative iteration.
1. Calling the API
Send requests to https://api.higgsfield.ai/minimax/h3-highspeed/text-to-video with a JSON body matching the parameters below.
Install
Install an official server-side SDK. cURL needs no package.
npm install @higgsfield/clientSetup
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 cURLRequest parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Prompt. Minimum length: 1. Maximum length: 7000. |
duration | integer | No | 5 | Duration. Minimum: 4. Maximum: 15. |
resolution | string | No | "768P" | Resolution. Options: 480P, 768P. |
aspect_ratio | string | No | "auto" | Aspect ratio. Options: auto, adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. |
aigc_watermark | boolean | No | false |
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_KEY3. 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
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-highspeed/text-to-video",
{
input: {
"prompt": "A slow camera move across a sunlit mountain lake",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9"
},
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.
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.
5. Pricing
| Resolution | Output video per second |
|---|---|
480P | $0.04 |
768P | $0.06 |
The total price is output duration × the rate for the selected resolution. A 5-second video costs $0.20 at 480P or $0.30 at 768P.