MiniMax Hailuo 2.3 Fast
The image-to-video express lane
- frameImages
- video
Hailuo 2.3 Fast is the i2v-first lane of MiniMax's video family, and the node layout tells you immediately: frameImages is the required input. Unlike the standard Hailuo 2.3 node, where you prompt from scratch, this one assumes you already have an image and want it moving - fast. It's the node for the workflow where you nail a still with an image model, then hand it to Hailuo to bring to life.
The "Fast" in the name is doing real work, too. Same Hailuo 2.3 generation underneath, but tuned for quicker turnaround - fewer total steps in the cloud means lower cost and shorter queue, at the cost of some polish on complex motion. For iterating on a shot, it's the right tool. When you've found the version you love and want the best render, you'd move up to the full 2.3 node with the same frame and prompt.
What you set
frameImages(required) - your starting still, asIMAGE. This is the star of the show.positivePrompt(optional) - what should happen. "The character turns and waves, camera slowly pushes in" is the kind of direction this node wants.width/height- keep them matching your input frame's aspect.durationtoggle +duration_value- seconds at the model's fps; off uses the default.providerSettings.minimax.promptOptimizer- prompt rewriting, off for reproducibility.safety.mode-none/fast/full.outputFormatMP4/WEBM/MOV,outputQuality20-99,numberResults1-4.
Output is video (VIDEO).
How it works
Standard Runware pack plumbing: build a request with the model AIR and taskType, upload your frames, send over REST via the SDK, and get the video back as a native VIDEO. Because it's the fast tier, the round trip is shorter than the flagship node - which is exactly why you'd chain: image model → this node → preview → promote the good ones to the full 2.3 render. Cost shows on the title bar; the fast tier keeps that number small enough that iteration isn't painful.
Installing
ComfyUI Manager → search Runware → install → restart. Manual:
cd ComfyUI/custom_nodes
git clone https://github.com/Runware/ComfyUI-Runware
pip install -r ComfyUI-Runware/requirements.txt
No model downloads; dependencies are runware-sdk, pillow, soundfile. API key via Settings → Runware API key, RUNWARE_API_KEY, or runware auth login.
Troubleshooting
Key first. If the node errors with nothing wired into frameImages, that's on you - it's required here by design, so check the socket. And remember this is the fast tier: if motion looks simplified on complex scenes, that's the speed trade, not a defect - promote the shot to the full Hailuo 2.3 node when it matters.
Inputs (14)
| Name | Type | Default | Description |
|---|---|---|---|
| frameImages | IMAGE | — | |
| positivePromptopt | STRING | Text prompt describing elements to include in the generated output. | |
| sizeopt | COMBO | 720p (1:1) | Output size. Only one of resolution or dimensions is sent. |
| durationopt | BOOLEAN | false | Enable to set duration. Off uses the model's default. |
| duration_valueopt | FLOAT | 0.00 | Length of the generated video in seconds. The total number of frames produced is determined by duration multiplied by the model's frame rate (fps). |
| numberResultsopt | INT | 11–4 | Number of results to generate. Each result uses a different seed, producing variations of the same parameters. |
| providerSettings.minimax.promptOptimizeropt | BOOLEAN | false | Enable automatic prompt optimization. Affects reproducibility. |
| safetyopt | BOOLEAN | false | Enable to set safety. Off uses the model's default. |
| safety.checkContentopt | BOOLEAN | false | Enable or disable content safety checking. |
| safety.modeopt | COMBO | fast | Safety checking mode for video generation. |
| ttlopt | BOOLEAN | false | Enable to set ttl. Off uses the model's default. |
| ttl_valueopt | INT | 60 | Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`. |
| outputFormatopt | COMBO | MP4 | File format for the generated video. |
| outputQualityopt | INT | 9520–99 | Compression quality of the output. Higher values preserve quality but increase file size. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| video | VIDEO | — |