> ## Documentation Index > Fetch the complete documentation index at: https://docs.comfy.org/llms.txt > Use this file to discover all available pages before exploring further. # 참고 # CLI ## 생성 (파트너 노드) — 베타 **`comfy generate`는 베타 버전입니다.** 플래그 이름, 모델 별칭 및 출력 형식은 변경될 수 있습니다. 기본 제공 파트너 엔드포인트는 안정적이나, CLI 표면은 여전히 발전 중입니다. [comfy-cli GitHub 리포지토리](https://github.com/Comfy-Org/comfy-cli/issues)에서 파일로 피드백을 보내주세요. **사용법**: ```console theme={null} $ comfy generate [옵션] <모델 또는 액션> [--<매개변수> 값]... ``` `<모델 또는 액션>`은 다음 중 하나입니다: * **모델 별칭**(예: `flux-pro`, `ideogram-edit`, `kling`, `dalle`) — 해당 파트너 모델을 직접 호출합니다. * **예약된 액션**: `list`, `schema`, `refresh`, `upload`, `resume`. 예약된 항목에 속하지 않는 모든 것은 모델 별칭으로 간주되며, 요청은 해당 파트너 엔드포인트로 전송됩니다. **인증**: `COMFY_API_KEY` 환경 변수를 설정하거나, 각 호출 시 `--api-key <키>`를 전달하세요. 키는 [platform.comfy.org](https://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`를 덮어씀). **예제**: ```bash theme={null} 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` 사용 가능한 파트너 모델과 그 짧은 별칭을 나열합니다. **사용법**: ```console theme={null} $ 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` 특정 모델의 매개변수를 표시하며, 필수/선택 플래그, 타입, 기본값 및 예제 호출을 포함합니다. **사용법**: ```console theme={null} $ comfy generate schema <모델> ``` **예제**: ```bash theme={null} comfy generate schema flux-pro comfy generate schema kling-i2v ``` ### `refresh` 클라우드 OpenAPI 사양에서 로컬 캐시된 모델 카탈로그를 새로 고칩니다. 새로운 파트너 모델이 추가되었을 때 유용합니다. **사용법**: ```console theme={null} $ comfy generate refresh ``` ### `upload` 로컬 파일을 Comfy의 스토리지에 업로드하거나(또는 원격 URL을 다시 호스팅) 서명된 URL을 출력합니다. 대부분의 모델은 로컬 파일 경로를 직접 받아들이지만, 명시적으로 URL을 원하는 경우(예: 여러 호출에서 동일한 자산을 재사용하기 위해) 사용합니다. **사용법**: ```console theme={null} $ comfy generate upload <파일 또는 URL> [--json] ``` **예제**: ```bash theme={null} 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`로 제출한 비디오 작업)을 다시 시작합니다. 결과가 준비될 때까지 폴링하고, 선택적으로 다운로드합니다. **사용법**: ```console theme={null} $ comfy generate resume <모델> <작업 ID> [--download PATH] [--json] ``` **예제**: ```bash theme={null} comfy generate resume luma 7c3f9e2a --download out.mp4 ``` ### 모델 별칭(선택) 다음 짧은 별칭들은 `<모델>`로 받아들여집니다. 전체 최신 카탈로그는 `comfy generate list`를 실행하세요. **인기 있는 것들**: | 별칭 | 파트너 | 카테고리 | | ------------------- | -------------------------- | ----------------------------------- | | `nano-banana` | Google(Gemini Flash Image) | text-to-image / image-edit | | `seedance` | ByteDance | text-to-video / image-to-video(비동기) | | `grok`, `grok-edit` | xAI | text-to-image / image-edit | | `grok-video` | xAI | text-to-video(비동기) | **그 외 모든 것**: | 별칭 | 파트너 | 카테고리 | | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------ | | `flux-pro`, `flux-ultra`, `flux-2` | BFL | text-to-image(비동기) | | `flux-kontext`, `flux-kontext-max` | BFL | image-edit(비동기) | | `flux-fill`, `flux-expand`, `flux-canny`, `flux-depth` | BFL | inpaint / outpaint / controlnet | | `ideogram`, `ideogram-edit`, `ideogram-remix`, `ideogram-reframe`, `ideogram-bg` | Ideogram | text-to-image / image-edit | | `dalle`, `dalle-edit` | OpenAI | text-to-image / image-edit | | `stability-ultra`, `stability-sd3`, `stability-upscale`, `stability-upscale-creative`, `stability-upscale-fast` | Stability | text-to-image / upscale | | `recraft`, `recraft-vectorize`, `recraft-rmbg`, `recraft-replace-bg`, `recraft-i2i`, `recraft-inpaint`, `recraft-upscale`, `recraft-upscale-creative` | Recraft | text-to-image / image-edit | | `reve`, `reve-edit` | Reve | text-to-image / image-edit | | `runway` | Runway | text-to-image | | `kling`, `kling-i2v`, `kling-extend`, `kling-lipsync` | Kling | text-to-video / image-to-video / video-extend / lipsync(비동기) | | `luma`, `luma-i2v` | Luma | text-to-video / image-to-video(비동기) | | `hailuo` | MiniMax | text-to-video(비동기) | | `runway-i2v` | Runway | image-to-video(비동기) | | `moonvalley-t2v`, `moonvalley-i2v` | Moonvalley | text-to-video / image-to-video(비동기) | | `pika`, `pika-i2v` | Pika | text-to-video / image-to-video(비동기) | | `vidu`, `vidu-i2v`, `vidu-extend` | Vidu | text-to-video / image-to-video / video-extend(비동기) | ## 노드 **사용법**: ```console theme={null} $ 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` **사용법**: ```console theme={null} $ deps-in-workflow [옵션] ``` **옵션**: * `--workflow TEXT`: 워크플로우 파일 (.json/.png) \[필수] * `--output TEXT`: 워크플로우 파일 (.json/.png) \[필수] * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `disable` **사용법**: ```console theme={null} $ disable [옵션] 인수... ``` **인수**: * `인수...`: 사용자 정의 노드 비활성화 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `enable` **사용법**: ```console theme={null} $ enable [옵션] 인수... ``` **인수**: * `인수...`: 사용자 정의 노드 활성화 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `fix` **사용법**: ```console theme={null} $ fix [옵션] 인수... ``` **인수**: * `인수...`: 지정된 사용자 정의 노드의 의존성 수정 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `install` **사용법**: ```console theme={null} $ install [옵션] 인수... ``` **인수**: * `인수...`: 사용자 정의 노드 설치 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `install-deps` **사용법**: ```console theme={null} $ install-deps [옵션] ``` **옵션**: * `--deps TEXT`: 의존성 사양 파일 (.json) * `--workflow TEXT`: 워크플로우 파일 (.json/.png) * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `reinstall` **사용법**: ```console theme={null} $ reinstall [옵션] 인수... ``` **인수**: * `인수...`: 사용자 정의 노드 재설치 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `restore-dependencies` **사용법**: ```console theme={null} $ restore-dependencies [옵션] ``` **옵션**: * `--help`: 이 메시지를 표시하고 종료합니다. ### `restore-snapshot` **사용법**: ```console theme={null} $ restore-snapshot [옵션] 경로 ``` **인수**: * `경로`: \[필수] **옵션**: * `--help`: 이 메시지를 표시하고 종료합니다. ### `save-snapshot` 현재 ComfyUI 환경의 스냅샷을 저장합니다 **사용법**: ```console theme={null} $ save-snapshot [옵션] ``` **옵션**: * `--output TEXT`: 출력 파일 경로를 지정합니다. (.json/.yaml) * `--help`: 이 메시지를 표시하고 종료합니다. ### `show` **사용법**: ```console theme={null} $ show [옵션] 인수... ``` **인수**: * `인수...`: \[installed|enabled|not-installed|disabled|all|snapshot|snapshot-list] \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `simple-show` **사용법**: ```console theme={null} $ simple-show [옵션] 인수... ``` **인수**: * `인수...`: \[installed|enabled|not-installed|disabled|all|snapshot|snapshot-list] \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `uninstall` **사용법**: ```console theme={null} $ uninstall [옵션] 인수... ``` **인수**: * `인수...`: 사용자 정의 노드 제거 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ### `update` **사용법**: ```console theme={null} $ update [옵션] 인수... ``` **인수**: * `인수...`: 사용자 정의 노드 업데이트 \[필수] **옵션**: * `--channel TEXT`: 작업 모드 지정 * `--mode TEXT`: \[remote|local|cache] * `--help`: 이 메시지를 표시하고 종료합니다. ## 모델 **사용법**: ```console theme={null} $ comfy model [옵션] 명령어 [인자]... ``` **옵션**: * `--install-completion`: 현재 셸에 대한 자동완성 기능을 설치합니다. * `--show-completion`: 현재 셸에 대한 자동완성을 표시하여 복사하거나 설치를 맞춤화할 수 있습니다. * `--help`: 이 메시지를 표시하고 종료합니다. **명령어**: * `download`: 지정된 상대 경로에 모델을 다운로드합니다... * `list`: 현재 다운로드된 모든 모델의 목록을 표시합니다... * `remove`: 하나 이상의 다운로드된 모델을 제거합니다... ### `download` 다운로드되지 않은 모델을 지정된 상대 경로에 다운로드합니다. **사용법**: ```console theme={null} $ download [옵션] ``` **옵션**: * `--url TEXT`: 모델을 다운로드할 URL \[필수] * `--relative-path TEXT`: 현재 작업 공간에서 모델을 설치할 상대 경로입니다. \[기본값: models/checkpoints] * `--help`: 이 메시지를 표시하고 종료합니다. ### `list` 현재 다운로드된 모든 모델의 목록을 표 형식으로 표시합니다. **사용법**: ```console theme={null} $ list [옵션] ``` **옵션**: * `--relative-path TEXT`: 모델이 저장된 현재 작업 공간에서의 상대 경로입니다. \[기본값: models/checkpoints] * `--help`: 이 메시지를 표시하고 종료합니다. ### `remove` 직접 지정하거나 대화형 선택을 통해 하나 이상의 다운로드된 모델을 제거합니다. **사용법**: ```console theme={null} $ remove [옵션] ``` **옵션**: * `--relative-path TEXT`: 모델이 저장된 현재 작업 공간에서의 상대 경로입니다. \[기본값: models/checkpoints] * `--model-names TEXT`: 삭제할 모델 파일명 목록 (공백으로 구분) * `--help`: 이 메시지를 표시하고 종료합니다.