This ComfyUI tutorial template shows how to turn a single image into an animated video using MiniMax H3 Max via the MinimaxHailuo03ReferenceNode. The core path is simple: you load a still frame with LoadImage, describe the motion in PrimitiveStringMultiline, and the MinimaxHailuo03ReferenceNode generates a video while preserving the source composition and aspect ratio. SaveVideo writes the final clip to disk, and SaveText can archive the exact prompt and response metadata for reproducibility.
Two optional paths are controlled by red ComfySwitchNode gates. The Prompt Enhancer (Optional) stage lets you route an alternate or refined prompt into the generator if you want cleaner wording without changing your base prompt field. The Upscale Video to 2K (Optional) stage adds a post-process branch for higher-resolution output, but it only accepts a 768p source—so you must generate at 768p in the core node if you plan to upscale. For more advanced control, MinimaxHailuo03ContextIRNode can be added to supply context/image-reference signals for stronger identity retention, and MinimaxHailuo03RegenerateNode enables quick re-runs with new seeds without reconfiguring inputs. This makes the template practical for animating character portraits, product shots, and concept visuals with prompt-driven motion while keeping the original look intact.
API
このワークフローをコードから利用
すべてのComfyワークフローはJSONグラフです。以下のペイロードは、このワークフローそのものであり、ComfyUIが実行する内容と同じです — このURLから取得し、バージョン管理に保存したり、ComfyUIで読み込んでノードごとに実行できます。
Comfy SDKを使ってTypeScriptまたはPythonから実行できます。同じコードでComfy Cloudや自身でホストしたComfyUIのどちらにも対応 — ベースURLだけが異なります。
// Install (beta)
npm i @comfyorg/sdk
// Run this workflow (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
const wf = await client.workflows.fromFile("workflow_api.json");
const job = await client.run(wf);
await job.getOutputs("<output-node-id>")[0].toFile("output.png");SDKはAPI形式のワークフローを受け取ります：このワークフローをComfyUIで開き、「ファイル → ワークフローをエクスポート（API）」を使用してください。
