메인 콘텐츠로 건너뛰기

​
CLI

​
생성 (파트너 노드) — 베타

comfy generate는 베타 버전입니다. 플래그 이름, 모델 별칭 및 출력 형식은 변경될 수 있습니다. 기본 제공 파트너 엔드포인트는 안정적이나, CLI 표면은 여전히 발전 중입니다. comfy-cli GitHub 리포지토리에서 파일로 피드백을 보내주세요.
사용법: 
$ comfy generate [옵션] <모델 또는 액션> [--<매개변수> 값]...
<모델 또는 액션>은 다음 중 하나입니다:
  • 모델 별칭(예: flux-pro, ideogram-edit, kling, dalle) — 해당 파트너 모델을 직접 호출합니다.
  • 예약된 액션: list, schema, refresh, upload, resume.
예약된 항목에 속하지 않는 모든 것은 모델 별칭으로 간주되며, 요청은 해당 파트너 엔드포인트로 전송됩니다. 인증: COMFY_API_KEY 환경 변수를 설정하거나, 각 호출 시 --api-key <키>를 전달하세요. 키는 platform.comfy.org에서 얻을 수 있습니다. 실행 레벨 플래그 (모든 모델과 함께 작동):
  • --download PATH: 결과 이미지/비디오를 PATH에 저장합니다.
  • --async: 작업을 제출하고 완료될 때까지 폴링하는 대신 즉시 작업 ID를 반환합니다. 나중에 comfy generate resume <모델> <작업 ID>로 다시 시작할 수 있습니다.
  • --json: 원시 API 응답을 JSON 형식으로 출력합니다(스크립팅에 유용함).
  • --timeout SECONDS: 기본 300초의 폴링 타임아웃을 재정의합니다.
  • --api-key KEY: 인라인 API 키(기존 COMFY_API_KEY를 덮어씀).
예제: 
comfy generate flux-pro --prompt "달 위의 고양이" --width 1024 --height 1024 --download cat.png
comfy generate ideogram-edit --image cat.png --mask m.png --prompt "선글라스 추가" --rendering_speed TURBO
comfy generate kling --prompt "황혼에 떠다니는 종이 보트" --duration 5 --download boat.mp4

​
list

사용 가능한 파트너 모델과 그 짧은 별칭을 나열합니다. 사용법: 
$ comfy generate list [옵션]
옵션:
  • --partner TEXT / -p TEXT: 파트너별 필터링(예: bfl, kling, ideogram, openai).
  • --category TEXT / --style TEXT / -c TEXT: 카테고리별 필터링(예: text-to-image, image-edit, inpaint, upscale, text-to-video, image-to-video).
  • --query TEXT / -q TEXT: 모델 ID나 요약에 대한 부분 문자열 일치.

​
schema

특정 모델의 매개변수를 표시하며, 필수/선택 플래그, 타입, 기본값 및 예제 호출을 포함합니다. 사용법: 
$ comfy generate schema <모델>
예제: 
comfy generate schema flux-pro
comfy generate schema kling-i2v

​
refresh

클라우드 OpenAPI 사양에서 로컬 캐시된 모델 카탈로그를 새로 고칩니다. 새로운 파트너 모델이 추가되었을 때 유용합니다. 사용법: 
$ comfy generate refresh

​
upload

로컬 파일을 Comfy의 스토리지에 업로드하거나(또는 원격 URL을 다시 호스팅) 서명된 URL을 출력합니다. 대부분의 모델은 로컬 파일 경로를 직접 받아들이지만, 명시적으로 URL을 원하는 경우(예: 여러 호출에서 동일한 자산을 재사용하기 위해) 사용합니다. 사용법: 
$ comfy generate upload <파일 또는 URL> [--json]
예제: 
comfy generate upload ./photo.jpg
comfy generate upload ./photo.jpg --json
참조 자산은 24시간 후에 자동 삭제됩니다. 업로드된 파일(‘comfy generate upload’를 통해 업로드하거나 모델에 로컬 파일 경로를 전달할 때 자동으로 업로드됨)은 Comfy가 관리하는 GCS 버킷(api-nodes-prod)에 저장되며, 서명된 URL을 통해서만 접근 가능합니다. 객체는 버킷 라이프사이클 규칙에 의해 업로드 후 1일 후에 자동 삭제됩니다. 장기간 실행되는 비동기 작업에서도 자산을 유지해야 한다면, 각 작업 전에 다시 업로드하거나 직접 호스팅한 후 URL을 직접 전달하세요.

​
resume

이전에 제출한 비동기 작업(일반적으로 --async로 제출한 비디오 작업)을 다시 시작합니다. 결과가 준비될 때까지 폴링하고, 선택적으로 다운로드합니다. 사용법: 
$ comfy generate resume <모델> <작업 ID> [--download PATH] [--json]
예제: 
comfy generate resume luma 7c3f9e2a --download out.mp4

​
모델 별칭(선택)

다음 짧은 별칭들은 <모델>로 받아들여집니다. 전체 최신 카탈로그는 comfy generate list를 실행하세요. 인기 있는 것들:
별칭파트너카테고리
nano-bananaGoogle(Gemini Flash Image)text-to-image / image-edit
seedanceByteDancetext-to-video / image-to-video(비동기)
grok, grok-editxAItext-to-image / image-edit
grok-videoxAItext-to-video(비동기)
그 외 모든 것:
별칭파트너카테고리
flux-pro, flux-ultra, flux-2BFLtext-to-image(비동기)
flux-kontext, flux-kontext-maxBFLimage-edit(비동기)
flux-fill, flux-expand, flux-canny, flux-depthBFLinpaint / outpaint / controlnet
ideogram, ideogram-edit, ideogram-remix, ideogram-reframe, ideogram-bgIdeogramtext-to-image / image-edit
dalle, dalle-editOpenAItext-to-image / image-edit
stability-ultra, stability-sd3, stability-upscale, stability-upscale-creative, stability-upscale-fastStabilitytext-to-image / upscale
recraft, recraft-vectorize, recraft-rmbg, recraft-replace-bg, recraft-i2i, recraft-inpaint, recraft-upscale, recraft-upscale-creativeRecrafttext-to-image / image-edit
reve, reve-editRevetext-to-image / image-edit
runwayRunwaytext-to-image
kling, kling-i2v, kling-extend, kling-lipsyncKlingtext-to-video / image-to-video / video-extend / lipsync(비동기)
luma, luma-i2vLumatext-to-video / image-to-video(비동기)
hailuoMiniMaxtext-to-video(비동기)
runway-i2vRunwayimage-to-video(비동기)
moonvalley-t2v, moonvalley-i2vMoonvalleytext-to-video / image-to-video(비동기)
pika, pika-i2vPikatext-to-video / image-to-video(비동기)
vidu, vidu-i2v, vidu-extendVidutext-to-video / image-to-video / video-extend(비동기)

​
노드

사용법: 
$ comfy node [옵션] 명령어 [인수]...
옵션:
  • --install-completion: 현재 셸에 대한 자동완성 기능을 설치합니다.
  • --show-completion: 현재 셸에 대한 자동완성을 표시하여 복사하거나 설치를 맞춤화할 수 있습니다.
  • --help: 이 메시지를 표시하고 종료합니다.
명령어:
  • deps-in-workflow
  • disable
  • enable
  • fix
  • install
  • install-deps
  • reinstall
  • restore-dependencies
  • restore-snapshot
  • save-snapshot: 현재 ComfyUI의 스냅샷을 저장합니다…
  • show
  • simple-show
  • uninstall
  • update

​
deps-in-workflow

사용법: 
$ deps-in-workflow [옵션]
옵션:
  • --workflow TEXT: 워크플로우 파일 (.json/.png) [필수]
  • --output TEXT: 워크플로우 파일 (.json/.png) [필수]
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
disable

사용법: 
$ disable [옵션] 인수...
인수:
  • 인수...: 사용자 정의 노드 비활성화 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
enable

사용법: 
$ enable [옵션] 인수...
인수:
  • 인수...: 사용자 정의 노드 활성화 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
fix

사용법: 
$ fix [옵션] 인수...
인수:
  • 인수...: 지정된 사용자 정의 노드의 의존성 수정 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
install

사용법: 
$ install [옵션] 인수...
인수:
  • 인수...: 사용자 정의 노드 설치 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
install-deps

사용법: 
$ install-deps [옵션]
옵션:
  • --deps TEXT: 의존성 사양 파일 (.json)
  • --workflow TEXT: 워크플로우 파일 (.json/.png)
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
reinstall

사용법: 
$ reinstall [옵션] 인수...
인수:
  • 인수...: 사용자 정의 노드 재설치 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
restore-dependencies

사용법: 
$ restore-dependencies [옵션]
옵션:
  • --help: 이 메시지를 표시하고 종료합니다.

​
restore-snapshot

사용법: 
$ restore-snapshot [옵션] 경로
인수:
  • 경로: [필수]
옵션:
  • --help: 이 메시지를 표시하고 종료합니다.

​
save-snapshot

현재 ComfyUI 환경의 스냅샷을 저장합니다 사용법: 
$ save-snapshot [옵션]
옵션:
  • --output TEXT: 출력 파일 경로를 지정합니다. (.json/.yaml)
  • --help: 이 메시지를 표시하고 종료합니다.

​
show

사용법: 
$ show [옵션] 인수...
인수:
  • 인수...: [installed|enabled|not-installed|disabled|all|snapshot|snapshot-list] [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
simple-show

사용법: 
$ simple-show [옵션] 인수...
인수:
  • 인수...: [installed|enabled|not-installed|disabled|all|snapshot|snapshot-list] [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
uninstall

사용법: 
$ uninstall [옵션] 인수...
인수:
  • 인수...: 사용자 정의 노드 제거 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
update

사용법: 
$ update [옵션] 인수...
인수:
  • 인수...: 사용자 정의 노드 업데이트 [필수]
옵션:
  • --channel TEXT: 작업 모드 지정
  • --mode TEXT: [remote|local|cache]
  • --help: 이 메시지를 표시하고 종료합니다.

​
모델

사용법: 
$ comfy model [옵션] 명령어 [인자]...
옵션:
  • --install-completion: 현재 셸에 대한 자동완성 기능을 설치합니다.
  • --show-completion: 현재 셸에 대한 자동완성을 표시하여 복사하거나 설치를 맞춤화할 수 있습니다.
  • --help: 이 메시지를 표시하고 종료합니다.
명령어:
  • download: 지정된 상대 경로에 모델을 다운로드합니다…
  • list: 현재 다운로드된 모든 모델의 목록을 표시합니다…
  • remove: 하나 이상의 다운로드된 모델을 제거합니다…

​
download

다운로드되지 않은 모델을 지정된 상대 경로에 다운로드합니다. 사용법: 
$ download [옵션]
옵션:
  • --url TEXT: 모델을 다운로드할 URL [필수]
  • --relative-path TEXT: 현재 작업 공간에서 모델을 설치할 상대 경로입니다. [기본값: models/checkpoints]
  • --help: 이 메시지를 표시하고 종료합니다.

​
list

현재 다운로드된 모든 모델의 목록을 표 형식으로 표시합니다. 사용법: 
$ list [옵션]
옵션:
  • --relative-path TEXT: 모델이 저장된 현재 작업 공간에서의 상대 경로입니다. [기본값: models/checkpoints]
  • --help: 이 메시지를 표시하고 종료합니다.

​
remove

직접 지정하거나 대화형 선택을 통해 하나 이상의 다운로드된 모델을 제거합니다. 사용법: 
$ remove [옵션]
옵션:
  • --relative-path TEXT: 모델이 저장된 현재 작업 공간에서의 상대 경로입니다. [기본값: models/checkpoints]
  • --model-names TEXT: 삭제할 모델 파일명 목록 (공백으로 구분)
  • --help: 이 메시지를 표시하고 종료합니다.