ComfyUI

드롭인 노드로 ComfyUI 안에서 Atlas Cloud 모델을 사용하세요. 로컬 GPU 없이 Seedance, Kling, Wan, Veo, Nano Banana, Seedream, FLUX 등을 쓸 수 있습니다.

Atlas Cloud ComfyUI 노드를 사용하면 ComfyUI 그래프에서 호스팅 모델을 호출할 수 있습니다. 생성은 Atlas Cloud에서 실행되므로 로컬 GPU 없이도 대형 동영상·이미지 모델을 사용할 수 있고, 이미 쓰고 있는 로컬 노드와 함께 조합할 수도 있습니다.

GitHub 저장소: AtlasCloudAI/atlascloud_comfyui

요구 사항

  • ComfyUI(데스크톱 앱 또는 소스 설치)
  • Python 3.10 이상
  • Atlas Cloud API 키 — console/api-keys에서 생성하세요

설치

cd ~/Documents/ComfyUI/custom_nodes
git clone https://github.com/AtlasCloudAI/atlascloud_comfyui.git
cd atlascloud_comfyui
~/Documents/ComfyUI/.venv/bin/python -m pip install -r requirements.txt

그런 다음 ComfyUI를 완전히 종료했다가 다시 여세요.

의존성은 requests, numpy, pillow로 가볍습니다.

의존성은 ComfyUI가 실제로 실행되는 Python 환경에 설치하세요. 다른 인터프리터를 사용하는 것이 설치 후 "module not found"가 발생하는 가장 흔한 원인입니다.

재시작하면 노드가 Node Library → AtlasCloud 아래에 나타납니다.

API 키 설정하기

키는 환경 변수에서 읽지 않습니다. 그래프에 AtlasCloud Client 노드를 추가하고 거기에 키를 붙여 넣으세요 — 이 노드가 자격 증명과 기본 URL을 보관하며, 다른 모든 Atlas Cloud 노드는 여기에서 연결 정보를 가져갑니다.

저장된 워크플로 JSON에는 클라이언트 노드에 입력한 내용이 그대로 포함될 수 있습니다. 워크플로 파일을 공개적으로 공유하기 전에 해당 필드를 비우세요.

빠른 시작

노드를 설치하고 ComfyUI를 재시작합니다.

클론한 저장소의 examples/01-text-to-image.json을 캔버스로 끌어다 놓습니다.

AtlasCloud Client 노드를 선택하고 API 키를 붙여 넣습니다.

그래프를 실행합니다.

예제 워크플로

저장소의 examples/에는 바로 실행할 수 있는 그래프가 들어 있습니다:

파일내용
01-text-to-image.json텍스트-투-이미지, 노드 3개
02-image-to-video.json이미지-투-비디오, 노드 5개
03-multi-reference-video.json레퍼런스 이미지를 최대 8장까지 사용하는 레퍼런스 기반 동영상, 노드 7개
parallel_video/3x_parallel_t2v.workflow.json텍스트-투-비디오 작업 3개를 병렬 실행

사용 가능한 모델

노드 세트는 Atlas Cloud 카탈로그를 따라가며 주요 모델 계열을 다룹니다:

  • 동영상 — Seedance, Kling, Wan, Veo, Hailuo, Vidu, PixVerse, LTX
  • 이미지 — Nano Banana, Seedream, GPT Image, FLUX, Qwen Image, Grok Imagine
  • 스튜디오 워크플로 — 제품 비주얼, 가상 피팅처럼 여러 단계를 패키징한 파이프라인

공통 유틸리티 노드로는 결과를 그 자리에서 확인할 수 있는 Image Previewer와 Video Previewer가 있습니다.

전체 카탈로그는 모델 라이브러리에서 살펴보세요.

선택적 환경 변수

변수용도
ATLAS_ALLOW_DEPRECATED_MODELS1로 설정하면 모델이 종료된 뒤에도 레거시 노드를 계속 표시해 기존 워크플로를 불러올 수 있습니다
ATLASCLOUD_HISTORY_DIR생성 이력을 로컬에 저장하는 위치를 변경합니다. 기본값은 사용자 프로필 아래의 애플리케이션 지원 디렉터리입니다

문제 해결

관련 문서

Last updated on

On this page