Hunyuan 비디오 1.5 이미지 기반 비디오 생성
정확한 동작 및 카메라 제어로 정지 이미지를 생동감 넘치는 동영상으로 애니메이션화합니다. 부드럽고 자연스러운 움직임으로 사진과 일러스트에 생명을 불어넣으며 시각적 일관성을 유지합니다.
워크플로 내부
소스 템플릿의 읽기 전용 미리보기입니다. Cloud에서 열어 노드를 살펴보고 변경할 수 있습니다.
코드에서 이 모델 호출하기
아래 요청은 Playground와 동일하게 준비된 그래프와 설정을 사용합니다. 제출할 때마다 유료 실행이 시작될 수 있으므로 결과를 알 수 없는 제출을 자동으로 재시도하지 마세요.
What you need
- Runs on
- Comfy Cloud
- 키
- COMFY_API_KEY
- 내 파일
- 코드가 해당 URL에서 업로드
유료 Cloud 요금제와 크레딧이 필요합니다.
# Python 3.10+: pip install comfy-sdk==0.4.0
import os
from comfy_sdk import Comfy
api_key = os.environ.get("COMFY_API_KEY", "").strip()
if not api_key: raise RuntimeError("Set COMFY_API_KEY")
os.environ.setdefault("COMFY_BASE_URL", "https://cloud.comfy.org")
client = Comfy(api_key=api_key)
workflow = client.workflows.from_json({
"8": {
"class_type": "VAEDecode",
"inputs": {
"samples": [
"125",
0
],
"vae": [
"10",
0
]
},
"_meta": {
"title": "VAE Decode"
}
},
"10": {
"class_type": "VAELoader",
"inputs": {
"vae_name": "hunyuanvideo15_vae_fp16.safetensors"
},
"_meta": {
"title": "Load VAE"
}
},
"11": {
"class_type": "DualCLIPLoader",
"inputs": {
"clip_name1": "qwen_2.5_vl_7b_fp8_scaled.safetensors",
"clip_name2": "byt5_small_glyphxl_fp16.safetensors",
"device": "default",
"type": "hunyuan_video_15"
},
"_meta": {
"title": "Load CLIP (Dual)"
}
},
"12": {
"class_type": "UNETLoader",
"inputs": {
"unet_name": "hunyuanvideo1.5_720p_i2v_fp16.safetensors",
"weight_dtype": "default"
},
"_meta": {
"title": "Load Diffusion Model"
}
},
"44": {
"class_type": "CLIPTextEncode",
"inputs": {
"clip": [
"11",
0
],
"text": "The bull elk stands on the mossy granite ledge above the fog-filled valley at dusk. It lifts its heavy antlered head, exhales a long plume of breath that curls into the cold air, then turns its neck to look back over its shoulder toward the camera before stepping carefully forward along the rock edge, hooves slipping slightly on the wet stone. Below, thick pewter mist rolls slowly through the dark hemlocks and spills over the ridges like a slow tide. The camera starts close at the elk's shoulder and cranes up and out in one smooth move, rising above the ledge to reveal the full misty valley stretching away, with silver rim light flickering through breaks in the storm clouds. Cinematic wildlife footage, natural motion, steady and unhurried."
},
"_meta": {
"title": "CLIP Text Encode (Positive Prompt)"
}
},
"78": {
"class_type": "HunyuanVideo15ImageToVideo",
"inputs": {
"batch_size": 1,
"clip_vision_output": [
"79",
0
],
"height": 720,
"length": 121,
"negative": [
"93",
0
],
"positive": [
"44",
0
],
"start_image": [
"80",
0
],
"vae": [
"10",
0
],
"width": 1280
},
"_meta": {
"title": "HunyuanVideo15ImageToVideo"
}
},
"79": {
"class_type": "CLIPVisionEncode",
"inputs": {
"clip_vision": [
"81",
0
],
"crop": "center",
"image": [
"80",
0
]
},
"_meta": {
"title": "CLIP Vision Encode"
}
},
"80": {
"class_type": "LoadImage",
"inputs": {
"image": "UPLOADED_image_FILENAME"
},
"_meta": {
"title": "Load Image"
}
},
"81": {
"class_type": "CLIPVisionLoader",
"inputs": {
"clip_name": "sigclip_vision_patch14_384.safetensors"
},
"_meta": {
"title": "Load CLIP Vision"
}
},
"93": {
"class_type": "CLIPTextEncode",
"inputs": {
"clip": [
"11",
0
],
"text": ""
},
"_meta": {
"title": "CLIP Text Encode (Negative Prompt)"
}
},
"101": {
"class_type": "CreateVideo",
"inputs": {
"bit_depth": "auto",
"codec": "none",
"color_space": "sRGB",
"fps": 24,
"images": [
"8",
0
]
},
"_meta": {
"title": "Create Video"
}
},
"102": {
"class_type": "SaveVideo",
"inputs": {
"filename_prefix": "video/hunyuan_video_1.5",
"format": "auto",
"format.codec": "h264",
"video": [
"101",
0
]
},
"_meta": {
"title": "Save Video"
}
},
"125": {
"class_type": "SamplerCustomAdvanced",
"inputs": {
"guider": [
"129",
0
],
"latent_image": [
"78",
2
],
"noise": [
"127",
0
],
"sampler": [
"128",
0
],
"sigmas": [
"126",
0
]
},
"_meta": {
"title": "SamplerCustomAdvanced"
}
},
"126": {
"class_type": "BasicScheduler",
"inputs": {
"denoise": 1,
"model": [
"12",
0
],
"scheduler": "simple",
"steps": 20
},
"_meta": {
"title": "BasicScheduler"
}
},
"127": {
"class_type": "RandomNoise",
"inputs": {
"noise_seed": 887963123424675
},
"_meta": {
"title": "RandomNoise"
}
},
"128": {
"class_type": "KSamplerSelect",
"inputs": {
"sampler_name": "euler"
},
"_meta": {
"title": "KSamplerSelect"
}
},
"129": {
"class_type": "CFGGuider",
"inputs": {
"cfg": 6,
"model": [
"130",
0
],
"negative": [
"78",
1
],
"positive": [
"78",
0
]
},
"_meta": {
"title": "CFG Guider"
}
},
"130": {
"class_type": "ModelSamplingSD3",
"inputs": {
"model": [
"12",
0
],
"shift": 7
},
"_meta": {
"title": "ModelSamplingSD3"
}
}
})
workflow.set_input("80", "image", client.assets.from_url("https://comfy.org/catalog-media/d312a006-8814-4525-9416-61b1de7a21ed/bea0b5d9-b558-48de-9899-f526d73b354f"))
# run() also passes api_key to the partner nodes in this workflow.
job = client.run(workflow, api_key=api_key)
for output in job.get_outputs("102"):
output.to_file(output.name)예시 사용해 보기
이 워크플로 정보
Hunyuan Video 1.5 이미지에서 비디오로 워크플로는 정적 이미지를 제어된 모션과 카메라 다이내믹스로 몰입감 있는 비디오로 변환하도록 설계되었습니다. 이 워크플로는 Hunyuan Video 모델을 활용하며, 이미지를 부드럽고 자연스럽게 움직이게 하면서도 시각적 일관성을 유지하는 능력으로 알려져 있습니다. 이 워크플로의 핵심 노드에는 VAEDecode, VAELoader, 그리고 HunyuanVideo15ImageToVideo가 포함되며, 이들은 함께 작동해 이미지를 디코딩하고 비디오 형식으로 처리합니다. 또한 CLIPTextEncode 및 CLIPVisionEncode 같은 고급 노드를 포함해 입력 이미지의 의미 이해와 시각 인코딩을 강화하여, 생성된 비디오가 일관되고 보기 좋게 나오도록 합니다.
기술적으로 이 워크플로는 여러 단계로 구성됩니다. 모델 로딩 및 이미지 업로드로 시작한 뒤, 프롬프트 설정과 비디오 크기 조정을 진행합니다. CreateVideo 및 SaveVideo 같은 노드를 사용해 최종 출력을 효율적으로 생성하고 이후 사용을 위해 올바르게 저장합니다. EasyCache 노드는 비디오 품질을 일부 희생하는 대신 처리 속도를 높이는 옵션을 제공하여, 사용자의 하드웨어 성능에 따라 유연하게 선택할 수 있습니다. 이로 인해 최소한의 수동 작업으로 정지 이미지에 움직임을 부여하려는 아티스트, 애니메이터, 콘텐츠 제작자에게 특히 유용합니다.
질문과 답변
EasyCache 노드는 워크플로 처리 속도를 높이기 위해 사용되지만, 비디오 품질이 낮아질 수 있습니다. 하드웨어 리소스가 제한적인 경우 유용합니다.
기본값인 20 스텝보다 추론 스텝을 늘리거나, 처리 시간이 제약이 아니라면 VAE Decode (Tiled) 옵션을 사용하세요.
'weight_dtype'를 'fp8_e4n3fn'으로 설정해 메모리 사용량을 줄이거나, 더 많은 VRAM이 있는 머신을 사용하는 것을 고려하세요.
예. 워크플로 설정에서 해당 옵션을 켜면 비디오를 1080P로 업스케일할 수 있지만, 더 많은 처리 성능이 필요할 수 있습니다.