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）。
