thoải mái

{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}`#Comfyui

Tạo hình ảnh, video và âm thanh bằng ComfyUI — cài đặt, khởi chạy, quản lý nút/mô hình, chạy quy trình công việc bằng cách chèn tham số. Sử dụng thoải mái-CLI chính thức cho vòng đời và API REST/WebSocket trực tiếp để thực thi.

Siêu dữ liệu kỹ năng


Nguồn	Đi kèm (được cài đặt theo mặc định)
Đường dẫn

skills/creative/comfyui ` | | Phiên bản |

comfyui

, `image-generation

, `stable-diffusion

, `flux

, `sd3

, `wan-video

, `hunyuan-video

, `creative

, `generative-ai

, video-generation | | Kỹ năng liên quan | XPROTECTX34XPROTECTX, image_gen |

Tham khảo: đầy đủ SKILL.md

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

#ComfyUI

Tạo hình ảnh, video, âm thanh và nội dung 3D thông qua ComfyUI bằng cách sử dụng comfy-CLI chính thức để thiết lập/vòng đời và API REST/WebSocket trực tiếp để thực hiện quy trình công việc.

Kỹ năng này có gì`**Tài liệu tham khảo (

`references/

):**

`official-CLI.md

mọi lệnh `comfy ...

, có cờ

`rest-API.md

Điểm cuối REST + WebSocket (cục bộ + đám mây), lược đồ tải trọng

`workflow-format.md

JSON định dạng API, các loại nút phổ biến, ánh xạ tham số

template-integrity.md — chuyển đổi comfyui-workflow-templates từ định dạng trình soạn thảo sang định dạng API: Định tuyến lại các phím nhập động, bỏ qua có dấu chấm ( `values.a

, `resize_type.width

), các vấn đề về đám mây (chuyển hướng 302, 1 đồng thời công việc miễn phí, trần VRAM 1080p), đường khâu ffmpeg tương thích với Discord. Tác giả của @purzbeats. Tải cái này bất cứ khi nào bạn đang bắt đầu từ một mẫu chính thức.

**Tập lệnh ( `scripts/

):**

Kịch bản	Mục đích

`_common.py
`	HTTP được chia sẻ, định tuyến trên đám mây, danh mục nút (không chạy trực tiếp)

`hardware_check.py
`	Thăm dò GPU/VRAM/đĩa → đề xuất cục bộ so với Comfy Cloud

`comfyui_setup.sh
`	Kiểm tra phần cứng + thoải mái-CLI + Cài đặt ComfyUI + khởi chạy + xác minh

`extract_schema.py
`	Đọc quy trình làm việc → liệt kê các thông số có thể kiểm soát + mô hình

`check_deps.py
`	Kiểm tra quy trình làm việc với máy chủ đang chạy → liệt kê các nút/mô hình bị thiếu

`auto_fix_deps.py
`	Chạy check_deps rồi
`comfy node install
` /
`comfy model download
`

`run_workflow.py
`	Chèn thông số, gửi, giám sát, tải xuống kết quả đầu ra (HTTP hoặc WS)

`run_batch.py
`	Gửi quy trình công việc N lần với các lần quét, song song với cấp độ của bạn

`ws_monitor.py
`	Trình xem WebSocket thời gian thực để thực thi công việc (tiến trình trực tiếp)

`health_check.py
`	Người chạy danh sách kiểm tra xác minh — thoải mái-CLI + máy chủ + mô hình + kiểm tra khói

`fetch_logs.py
`	Kéo thông báo truy nguyên/trạng thái cho một dấu nhắc_id nhất định

**Quy trình làm việc mẫu ( `workflows/

):** SD 1.5, SDXL, Flux Dev, SDXL img2img, Sơn màu SDXL, nâng cấp ESRGAN, video AnimateDiff, Wan T2V. Xem `workflows/README.md

Khi nào nên sử dụng

Người dùng yêu cầu tạo hình ảnh với Stable Diffusion, SDXL, Flux, SD3, v.v.
Người dùng muốn chạy một tệp quy trình công việc ComfyUI cụ thể
Người dùng muốn xâu chuỗi các bước tổng quát (txt2img → nâng cấp → khôi phục khuôn mặt)
Người dùng cần ControlNet, inpainting, img2img hoặc các đường dẫn nâng cao khác
Người dùng yêu cầu quản lý hàng đợi ComfyUI, kiểm tra mô hình hoặc cài đặt các nút tùy chỉnh
Người dùng muốn tạo video/âm thanh/3D thông qua AnimateDiff, Hunyuan, Wan, AudioCraft, v.v.

Kiến trúc: Hai lớp`

┌─────────────────────────────────────────────────────┐ │ Layer 1: comfy-CLI (official lifecycle tool) │ │ Setup, server lifecycle, custom nodes, models │ │ → comfy install / launch / stop / node / model │ └─────────────────────────┬───────────────────────────┘ │ ┌─────────────────────────▼───────────────────────────┐ │ Layer 2: REST/WebSocket API + skill scripts │ │ Workflow execution, param injection, monitoring │ │ POST /API/prompt, GET /API/view, WS /ws │ │ → run_workflow.py, run_batch.py, ws_monitor.py │ └─────────────────────────────────────────────────────┘

Tại sao lại là hai lớp? CLI chính thức rất tuyệt vời cho việc cài đặt và máy chủ quản lý nhưng có hỗ trợ thực hiện quy trình công việc tối thiểu. API REST/WS lấp đầy khoảng trống đó - các tập lệnh xử lý việc chèn thông số, giám sát thực thi và tải xuống đầu ra mà CLI không thực hiện.

Bắt đầu nhanh

Phát hiện môi trường

# What's available?
command -v comfy >/dev/null 2>&1 && echo "comfy-CLI: installed"
curl -s http://127.0.0.1:8188/system_stats 2>/dev/null && echo "server: running"

# Can this machine run ComfyUI locally? (GPU/VRAM/disk check)
Python3 scripts/hardware_check.py

`
``Nếu chưa cài đặt gì, hãy xem **Thiết lập & triển khai** bên dưới — nhưng luôn chạy
kiểm tra phần cứng trước.

### Kiểm tra sức khỏe một dòng

``` bash
Python3 scripts/health_check.py

# → JSON: comfy_CLI on PATH? server reachable? at least one checkpoint? smoke-test passes?

`

## Quy trình làm việc cốt lõi

### Bước 1: Nhận JSON quy trình công việc ở định dạng API

Quy trình công việc phải ở định dạng API (mỗi nút có 
`class_type

). Họ đến từ:- Giao diện người dùng web ComfyUI → **Quy trình làm việc → Xuất (API)** (Giao diện người dùng mới hơn) hoặc
  nút "Lưu (Định dạng API)" cũ (giao diện người dùng cũ hơn)
- Thư mục 
`workflows/
` của kỹ năng này (ví dụ sẵn sàng để chạy)
- Tải xuống cộng đồng (civitai, Reddit, Discord) - thường là định dạng trình soạn thảo,
  phải được tải vào ComfyUI sau đó xuất lại

Định dạng trình soạn thảo (mảng 
`nodes
` và 
`links
` cấp cao nhất) **không trực tiếp
có thể thực thi được**. Các tập lệnh phát hiện điều này và yêu cầu bạn xuất lại.

### Bước 2: Xem những gì có thể kiểm soát được

``` bash
Python3 scripts/extract_schema.py workflow_API.JSON --summary-only

# → \&#123;"parameter_count": 12, "has_negative_prompt": true, "has_seed": true, ...&#125;

Python3 scripts/extract_schema.py workflow_API.JSON
# → full schema with parameters, model deps, embedding refs

`

### Bước 3: Chạy với tham số

``` bash

# Local (defaults to http://127.0.0.1:8188)
Python3 scripts/run_workflow.py \
  --workflow workflow_API.JSON \
  --args '\&#123;"prompt": "a beautiful sunset over mountains", "seed": -1, "steps": 30&#125;' \
  --output-dir ./outputs

# Cloud (export API key once; uses correct /API routing automatically)
 export COMFY_CLOUD_API_KEY="comfyui-..."
Python3 scripts/run_workflow.py \
  --workflow workflow_API.JSON \
  --args '\&#123;"prompt": "..."&#125;' \
  --host https://cloud.comfy.org \
  --output-dir ./outputs

# Real-time progress via WebSocket (requires 
`pip install websocket-CLIent

)
Python3 scripts/run_workflow.py \
  --workflow flux_dev.JSON \
  --args '\&#123;"prompt": "..."&#125;' \
  --ws

# img2img / inpaint: pass --input-image to upload + reference automatically
Python3 scripts/run_workflow.py \
  --workflow sdxl_img2img.JSON \
  --input-image image=./photo.png \
  --args '\&#123;"prompt": "make it watercolor", "denoise": 0.6&#125;'

# Batch / sweep: 8 random seeds, parallel up to cloud tier limit
Python3 scripts/run_batch.py \
  --workflow sdxl.JSON \
  --args '\&#123;"prompt": "abstract"&#125;' \
  --count 8 --randomize-seed --parallel 3 \
  --output-dir ./outputs/batch

`

-1
` cho 
`seed
` (hoặc bỏ qua 

--randomize-seed

) tạo ra một
hạt giống ngẫu nhiên mỗi lần chạy.

### Bước 4: Trình bày kết quả

Các tập lệnh phát ra JSON tới thiết bị xuất chuẩn mô tả mọi tệp đầu ra:

``` json
&#123;
  "status": "success",
  "prompt_id": "abc-123",
  "outputs": [
    \&#123;"file": "./outputs/sdxl_00001_.png", "node_id": "9",
     "type": "image", "filename": "sdxl_00001_.png"&#125;
  ]
&#125;

`

## Cây quyết định

| Người dùng nói | Công cụ | Lệnh |
|----------|------|----------|
| **Vòng đời (sử dụng thoải mái-CLI)** | | |
| "cài đặt ComfyUI" | thoải mái-CLI |

bash scripts/comfyui_setup.sh
` |
| "bắt đầu ComfyUI" | thoải mái-CLI |

comfy launch --background
` |
| "dừng ComfyUI" | thoải mái-CLI |

comfy stop
` |
| "cài đặt nút X" | thoải mái-CLI |

comfy node install &lt;name
` |
| "tải xuống mô hình X" | thoải mái-CLI |

comfy model download --url &lt;url --relative-path models/checkpoints
` |
| "liệt kê các model đã cài đặt" | thoải mái-CLI |

comfy model list
` |
| "liệt kê các nút đã cài đặt" | thoải mái-CLI |

comfy node show installed
` |
| **Thực thi (sử dụng tập lệnh)** | | |
| "Mọi thứ đã sẵn sàng chưa?" | kịch bản |

health_check.py
` (tùy chọn với 

`
--workflow X --smoke-test

) |
| "Tôi có thể thay đổi điều gì trong quy trình làm việc này?" | kịch bản |

extract_schema.py W.JSON
` |
| "kiểm tra xem mục tiêu của W có được đáp ứng không" | kịch bản |

check_deps.py W.JSON
` |
| "sửa lỗi thiếu" | kịch bản |

auto_fix_deps.py W.JSON
` |
| "tạo hình ảnh" | kịch bản |

run_workflow.py --workflow W --args '\&#123;...&#125;'
` |
| "sử dụng hình ảnh này" (img2img) | kịch bản |

run_workflow.py --input-image image=./x.png ...
` |
| "8 biến thể với hạt giống ngẫu nhiên" | kịch bản |

run_batch.py --count 8 --randomize-seed ...
` |
| "cho tôi xem tiến trình trực tiếp" | kịch bản |

ws_monitor.py --prompt-id &lt;id
` |
| "lấy lỗi từ công việc X" | kịch bản |

fetch_logs.py &lt;prompt_id
` |
| **NGƯỜI TRỰC TIẾP** | | |
| "Có gì trong hàng đợi vậy?" | NGHỈ LẠI |

curl http://HOST:8188/queue
` (cục bộ) hoặc 

--host https://cloud.comfy.org
` |
| "hủy cái đó" | NGHỈ LẠI |

curl -X POST http://HOST:8188/interrupt
` |
| "bộ nhớ GPU miễn phí" | NGHỈ LẠI |

curl -X POST http://HOST:8188/free
` |

## Thiết lập & giới thiệu

Khi người dùng yêu cầu thiết lập ComfyUI, **điều ĐẦU TIÊN cần làm là hỏi xem liệu
họ muốn Comfy Cloud (được lưu trữ, không cần cài đặt, khóa API) hoặc Local (cài đặt
ComfyUI trên máy của họ)**. Đừng bắt đầu chạy lệnh cài đặt hoặc phần cứng
kiểm tra cho đến khi họ trả lời.

**Tài liệu chính thức:** https://docs.comfy.org/installation
**Tài liệu CLI:** https://docs.comfy.org/comfy-CLI/getting-started
**Tài liệu đám mây:** https://docs.comfy.org/get_started/cloud
**API đám mây:** https://docs.comfy.org/development/cloud/overview

### Bước 0: Hỏi Local vs Cloud (LUÔN LUÔN ĐẦU TIÊN)

Kịch bản được đề xuất:`> "Bạn muốn chạy ComfyUI cục bộ trên máy của mình hay sử dụng Comfy Cloud?
>
> - **Comfy Cloud** — được lưu trữ trên GPU RTX 6000 Pro, tất cả các mẫu phổ biến đều được cài đặt sẵn,
> không thiết lập. Yêu cầu khóa API (cần đăng ký trả phí để thực sự chạy
> quy trình công việc; cấp miễn phí là chỉ đọc). Tốt nhất nếu bạn không có GPU có khả năng.
> - **Local** — miễn phí, nhưng máy của bạn PHẢI đáp ứng các yêu cầu về phần cứng:
> - GPU NVIDIA có ** ≥6 GB VRAM** ( ≥8 GB cho SDXL, ≥12 GB cho Flux/video), HOẶC
> - GPU AMD có hỗ trợ ROCm (Linux), HOẶC
> - Apple Silicon Mac (M1+) có **bộ nhớ hợp nhất ≥16 GB** (khuyến nghị ≥32 GB).
> - Máy Mac Intel và máy không có GPU sẽ KHÔNG hoạt động — thay vào đó hãy sử dụng Đám mây.
>
> Bạn muốn cái nào?”

Định tuyến:
- **Cloud** → chuyển tới **Đường dẫn A**.
- **Cục bộ** → chạy kiểm tra phần cứng trước, sau đó chọn đường dẫn từ Đường dẫn B–E dựa trên kết quả.
- **Không chắc chắn** → chạy kiểm tra phần cứng và để phán quyết quyết định.

### Bước 1: Xác minh phần cứng (CHỈ nếu người dùng chọn cục bộ)

``` bash
Python3 scripts/hardware_check.py --JSON

# Optional: also probe 
`torch
` for actual CUDA/MPS:
Python3 scripts/hardware_check.py --JSON --check-pytorch

`

| Phán quyết | Ý nghĩa | Hành động |
|-------------|------------------------------------------------------------------------|--------|
| 
`ok
` | ≥8 GB VRAM (rời) HOẶC ≥32 GB hợp nhất (Apple Silicon) | Cài đặt cục bộ - sử dụng 
`comfy_CLI_flag
` từ báo cáo |
| 
`marginal
` | SD1.5 hoạt động; SDXL chặt chẽ; Thông lượng/video khó xảy ra | OK cục bộ cho quy trình công việc nhẹ, nếu không **Đường dẫn A (Đám mây)** |
| 
`cloud
` | Không có GPU có thể sử dụng được, &lt;6 GB VRAM, &lt;16 GB Apple hợp nhất, Intel Mac, Rosetta Python | **Chuyển sang Đám mây** trừ khi người dùng buộc phải sử dụng cục bộ |Tập lệnh cũng hiển thị 
`wsl: true
` (WSL2 với thông qua NVIDIA) và
`rosetta: true
` (x86_64 Python trên Apple Silicon - phải cài đặt lại dưới dạng ARM64).

Nếu phán quyết là 
`cloud
` nhưng người dùng muốn cục bộ, đừng tiến hành âm thầm.
Hiển thị nguyên văn mảng 
`notes
` và hỏi xem họ có muốn (a) chuyển sang
Đám mây hoặc (b) buộc cài đặt cục bộ (sẽ OOM hoặc chậm đến mức không thể sử dụng được trên các mô hình hiện đại).

### Chọn đường dẫn cài đặt

Sử dụng kiểm tra phần cứng đầu tiên. Bảng bên dưới là dự phòng khi
người dùng đã cho bạn biết phần cứng của họ:

| Tình huống | Đường dẫn được đề xuất |
|----------||-------------------|
| 
`verdict: cloud
` từ kiểm tra phần cứng | **Đường dẫn A: Đám mây thoải mái** |
| Không có GPU / muốn thử mà không cần cam kết | **Đường dẫn A: Đám mây thoải mái** |
| Windows + NVIDIA + phi kỹ thuật | **Đường dẫn B: Máy tính để bàn ComfyUI** |
| Windows + NVIDIA + kỹ thuật | **Đường dẫn C: Di động** hoặc **Đường dẫn D: thoải mái-CLI** |
| Linux + bất kỳ GPU nào | **Đường dẫn D: thoải mái-CLI** (dễ nhất) |
| macOS + Apple Silicon | **Đường dẫn B: Máy tính để bàn** hoặc **Đường dẫn D: thoải mái-CLI** |
| Không đầu / máy chủ / CI / đại lý | **Đường dẫn D: thoải mái-CLI** |

Đối với đường dẫn hoàn toàn tự động (kiểm tra phần cứng → cài đặt → khởi chạy → xác minh):

``` bash
bash scripts/comfyui_setup.sh

# Or with overrides:
bash scripts/comfyui_setup.sh --m-series --port=8190 --workspace=/data/comfy

`
``Nó chạy 
`hardware_check.py
` nội bộ, từ chối cài đặt cục bộ khi
phán quyết là 
`cloud
` (trừ 

--force-cloud-override

), chọn đúng
Cờ 
`comfy-CLI
` và ưu tiên 
`pipx

/
`uvx
` hơn 
`pip
` toàn cầu để tránh gây ô nhiễm
hệ thống Python.

---

### Đường dẫn A: Comfy Cloud (Không cần cài đặt cục bộ)

Dành cho người dùng không có GPU đủ mạnh hoặc những người không muốn thiết lập. Được lưu trữ trên RTX 6000 Pro.

**Tài liệu:** https://docs.comfy.org/get_started/cloud
1. Đăng ký tại https://comfy.org/cloud
2. Tạo khóa API tại https://platform.comfy.org/login
3. Đặt chìa khóa:

``` bash
   export COMFY_CLOUD_API_KEY="comfyui-xxxxxxxxxxxx"

`

4. Chạy quy trình công việc:

``` bash
   Python3 scripts/run_workflow.py \

     --workflow workflows/flux_dev_txt2img.JSON \
     --args '\&#123;"prompt": "..."&#125;' \
     --host https://cloud.comfy.org \
     --output-dir ./outputs

``**Giá cả:** https://www.comfy.org/cloud/pricing
**Công việc đồng thời:** Miễn phí/Tiêu chuẩn 1, Creator 3, Pro 5. Bậc miễn phí
**không thể chạy quy trình công việc qua API** — chỉ duyệt qua các mô hình. Đăng ký trả phí
cần thiết cho 

/API/prompt

, 

/API/upload/*

, 

/API/view

, v.v.

---

### Đường dẫn B: ComfyUI Desktop (Windows/macOS)

Trình cài đặt chỉ bằng một cú nhấp chuột dành cho người dùng không rành về kỹ thuật. Hiện tại là Beta.

**Tài liệu:** https://docs.comfy.org/installation/desktop
- **Windows (NVIDIA):** https://download.comfy.org/Windows/nsis/x64
- **macOS (Apple Silicon):** https://comfy.org

Linux **không được hỗ trợ** cho Máy tính để bàn - sử dụng Đường dẫn D.

---

### Đường dẫn C: ComfyUI Portable (Chỉ dành cho Windows)

**Tài liệu:** https://docs.comfy.org/installation/comfyui_portable_Windows

Tải xuống từ https://GitHub.com/comfyanonymous/ComfyUI/releases, giải nén,
chạy 
`run_nvidia_gpu.bat

. Cập nhật qua 
`update/update_comfyui_stable.bat

.

---

### Đường dẫn D: thoải mái-CLI (Tất cả nền tảng - Được đề xuất cho Đại lý)

CLI chính thức là đường dẫn tốt nhất cho thiết lập không đầu/tự động.

**Tài liệu:** https://docs.comfy.org/comfy-CLI/getting-started

#### Cài đặt thoải mái-CLI

``` bash

# Recommended:
pipx install comfy-CLI
# Or use uvx without installing:
uvx --from comfy-CLI comfy --help
# Or (if pipx/uvx unavailable):
pip install --user comfy-CLI

`
``Vô hiệu hóa phân tích không tương tác:

`
``` bash
comfy --skip-prompt tracking disable

`

#### Cài đặt ComfyUI

`bash
comfy --skip-prompt install --nvidia              # NVIDIA (CUDA)
comfy --skip-prompt install --amd                 # AMD (ROCm, Linux)
comfy --skip-prompt install --m-series            # Apple Silicon (MPS)
comfy --skip-prompt install --cpu                 # CPU only (slow)
comfy --skip-prompt install --nvidia --fast-deps  # uv-based dep resolution

`
``Vị trí mặc định: 

~/comfy/ComfyUI
` (Linux), 

~/Documents/comfy/ComfyUI

(macOS/Win). Ghi đè bằng 
`comfy --workspace /custom/path install

.

#### Khởi chạy / xác minh

`bash
comfy launch --background                       # background daemon on :8188
comfy launch -- --listen 0.0.0.0 --port 8190    # LAN-accessible custom port
curl -s http://127.0.0.1:8188/system_stats      # health check

`

---

### Đường dẫn E: Cài đặt thủ công (Phần cứng nâng cao / không được hỗ trợ)

Dành cho Ascend NPU, Cambricon MLU, Intel Arc hoặc phần cứng không được hỗ trợ khác.

**Tài liệu:** https://docs.comfy.org/installation/manual_install

`bash
git clone https://GitHub.com/comfyanonymous/ComfyUI.git
cd ComfyUI
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
pip install -r requirements.txt
Python main.py

`

---

### Sau khi cài đặt: Tải xuống mô hình

`bash

# SDXL (general purpose, ~6.5 GB)
comfy model download \
  --url "https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_base_1.0.safetensors" \
  --relative-path models/checkpoints

# SD 1.5 (lighter, ~4 GB, good for 6 GB cards)
comfy model download \
  --url "https://huggingface.co/stable-diffusion-v1-5/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors" \
  --relative-path models/checkpoints

# Flux Dev fp8 (smaller variant, ~12 GB)
comfy model download \
  --url "https://huggingface.co/Comfy-Org/flux1-dev/resolve/main/flux1-dev-fp8.safetensors" \
  --relative-path models/checkpoints

# CivitAI (set token first):
comfy model download \
  --url "https://civitai.com/API/download/models/128713" \
  --relative-path models/checkpoints \
  --set-civitai-API-token "YOUR_TOKEN"

`
``Danh sách đã cài đặt: 
`comfy model list

.

### Sau khi cài đặt: Cài đặt nút tùy chỉnh

``` bash
comfy node install comfyui-impact-pack             # popular utility pack
comfy node install comfyui-animatediff-evolved     # video generation
comfy node install comfyui-controlnet-aux          # ControlNet preprocessors
comfy node install comfyui-essentials              # common helpers
comfy node update all
comfy node install-deps --workflow=workflow.JSON   # install everything a workflow needs

`

### Sau khi cài đặt: Xác minh

`bash
Python3 scripts/health_check.py

# → comfy_CLI on PATH? server reachable? checkpoints? smoke test?

Python3 scripts/check_deps.py my_workflow.JSON
# → are this workflow's nodes/models/embeddings installed?

Python3 scripts/run_workflow.py \
  --workflow workflows/sd15_txt2img.JSON \
  --args '\&#123;"prompt": "test", "steps": 4&#125;' \
  --output-dir ./test-outputs

`

## Tải lên hình ảnh (img2img / Inpainting)

Cách đơn giản nhất là sử dụng 

--input-image
` với 
`run_workflow.py

:

``` bash
Python3 scripts/run_workflow.py \

  --workflow workflows/sdxl_img2img.JSON \
  --input-image image=./photo.png \
  --args '\&#123;"prompt": "make it cyberpunk", "denoise": 0.6&#125;'

`
``Cờ tải lên 
`photo.png

, sau đó đưa tên tệp phía máy chủ của nó vào
bất kỳ tham số lược đồ nào cũng được đặt tên là 
`image

. Để inpainting, hãy vượt qua cả hai:

``` bash
Python3 scripts/run_workflow.py \

  --workflow workflows/sdxl_inpaint.JSON \
  --input-image image=./photo.png \
  --input-image mask_image=./mask.png \
  --args '\&#123;"prompt": "fill with flowers"&#125;'

`
``Tải lên thủ công qua REST:

`
``` bash
curl -X POST "http://127.0.0.1:8188/upload/image" \

  -F "image=@photo.png" -F "type=input" -F "overwrite=true"
# Returns: \&#123;"name": "photo.png", "subfolder": "", "type": "input"&#125;

# Cloud equivalent:
curl -X POST "https://cloud.comfy.org/API/upload/image" \
  -H "X-API-Key: $COMFY_CLOUD_API_KEY" \
  -F "image=@photo.png" -F "type=input" -F "overwrite=true"

`

## Thông số cụ thể của đám mây- **URL cơ sở:** 
`https://cloud.comfy.org

- **Auth:** Tiêu đề 
`X-API-Key
` (hoặc 

?token=KEY
` cho WebSocket)
- **Khóa API:** đặt 

$COMFY_CLOUD_API_KEY
` một lần và các tập lệnh sẽ tự động nhận nó
- **Tải xuống đầu ra:** 

/API/view
` trả về 302 cho URL đã ký; kịch bản
  theo dõi nó và loại bỏ 
`X-API-Key
` trước khi tìm nạp từ phần phụ trợ lưu trữ
  (không rò rỉ khóa API sang S3/CloudFront).
- **Sự khác biệt về điểm cuối so với ComfyUI cục bộ:**
  - 

/API/object_info

, 

/API/queue

, 

/API/userdata
` — **403 trên bậc miễn phí**;
    chỉ được trả tiền.
  - 

/history
` được đổi tên thành 

/history_v2
` trên đám mây (lộ trình tập lệnh
    tự động).
  - 

/models/&lt;folder
` được đổi tên thành 

/experiment/models/&lt;folder
` trên đám mây
    (các tập lệnh định tuyến tự động).
  - 
`CLIentId
` trong WebSocket hiện bị bỏ qua — tất cả các kết nối cho một
    người dùng nhận được cùng một chương trình phát sóng. Lọc theo phía máy khách 
`prompt_id

.
  - 
`subfolder
` được chấp nhận khi tải lên nhưng bị bỏ qua — đám mây có không gian tên phẳng.
- **Công việc đồng thời:** Miễn phí/Tiêu chuẩn: 1, Người tạo: 3, Chuyên nghiệp: 5. Hàng đợi bổ sung
  tự động. Sử dụng 
`run_batch.py --parallel N
` để bão hòa cấp độ của bạn.

## Quản lý hàng đợi & hệ thống

``` bash

# Local
curl -s http://127.0.0.1:8188/queue | Python3 -m JSON.tool
curl -X POST http://127.0.0.1:8188/queue -d '\&#123;"clear": true&#125;'    # cancel pending
curl -X POST http://127.0.0.1:8188/interrupt                      # cancel running
curl -X POST http://127.0.0.1:8188/free \
  -H "Content-Type: application/JSON" \
  -d '\&#123;"unload_models": true, "free_memory": true&#125;'

# Cloud — same paths under /API/, plus:
Python3 scripts/fetch_logs.py --tail-queue --host https://cloud.comfy.org

`

## Cạm bẫy
1. **Yêu cầu định dạng API** — mọi tập lệnh và điểm cuối 

/API/prompt
` đều mong đợi
   Quy trình làm việc có định dạng API JSON. Các tập lệnh phát hiện định dạng trình soạn thảo (cấp cao nhất
   mảng 
`nodes
` và 
`links

) và yêu cầu bạn xuất lại qua
   "Quy trình làm việc → Xuất (API)" (Giao diện người dùng mới hơn) hoặc "Lưu (Định dạng API)" (Giao diện người dùng cũ hơn).
2. **Máy chủ phải đang chạy** — tất cả quá trình thực thi đều yêu cầu máy chủ trực tiếp.

comfy launch --background
` khởi động một. Xác minh với``curl http://127.0.0.1:8188/system_stats

.
3. **Tên mẫu là chính xác** — phân biệt chữ hoa chữ thường, bao gồm phần mở rộng tệp.

check_deps.py
` thực hiện khớp mờ (có/không có phần mở rộng và thư mục
   tiền tố), nhưng bản thân quy trình làm việc phải sử dụng tên chuẩn. sử dụng``comfy model list
` để khám phá những gì đã được cài đặt.
4. **Thiếu nút tùy chỉnh** — "không tìm thấy class_type" nghĩa là nút bắt buộc
   chưa được cài đặt. 
`check_deps.py
` báo cáo gói nào cần cài đặt;``auto_fix_deps.py
` chạy cài đặt cho bạn.
5. **Thư mục làm việc** — 
`comfy-CLI
` tự động phát hiện không gian làm việc ComfyUI.
   Nếu lệnh thất bại với "không tìm thấy không gian làm việc", hãy sử dụng``comfy --workspace /path/to/ComfyUI &lt;command
` hoặc``comfy set-default /path/to/ComfyUI

.
6. **Giới hạn API cấp miễn phí của đám mây** — 

/API/prompt

, 

/API/view

, 

/API/upload/*

,
/API/object_info
` đều trả về 403 trên tài khoản miễn phí. 
`health_check.py
` và``check_deps.py
` xử lý việc này một cách khéo léo và đưa ra thông báo rõ ràng.
7. **Hết thời gian chờ cho quy trình làm việc video/âm thanh** — được tự động phát hiện khi có nút đầu ra
   là 
`VHS_VideoCombine

, 
`SaveVideo

, v.v.; mặc định nhảy từ 300 giây tới
   900 giây. Ghi đè rõ ràng bằng 

--timeout 1800

.
8. **Truyền tải đường dẫn trong tên tệp đầu ra** — tên tệp do máy chủ cung cấp là
   đã chuyển qua 
`safe_path_join
` để từ chối mọi thứ thoát ra khỏi 

--output-dir

.
   Luôn bật tính năng bảo vệ này — quy trình làm việc với các nút lưu tùy chỉnh có thể tạo ra
   những đường đi tùy ý.
9. **JSON quy trình làm việc là mã tùy ý** — các nút tùy chỉnh chạy Python, vì vậy
   việc gửi một quy trình công việc không xác định có cùng hồ sơ tin cậy như 
`eval

.
   Kiểm tra quy trình công việc từ các nguồn không đáng tin cậy trước khi chạy.
10. **Hạt giống tự động ngẫu nhiên** — vượt qua 
`seed: -1
` trong 

--args
` (hoặc sử dụng
--randomize-seed
` và bỏ qua hạt giống) để có được hạt giống mới mỗi lần chạy.
    Hạt giống thực tế được ghi vào stderr.
11. **Lời nhắc 
`tracking

** — lần chạy đầu tiên của 
`comfy
` có thể nhắc nhở phân tích.
    Sử dụng 
`comfy --skip-prompt tracking disable
` để bỏ qua phần không tương tác.

comfyui_setup.sh
` thực hiện điều này cho bạn.

## Danh sách kiểm tra xác minh

Sử dụng 
`Python3 scripts/health_check.py
` để chạy toàn bộ danh sách cùng một lúc. Hướng dẫn sử dụng:
- [ ] Phán quyết của 
`hardware_check.py
` là 
`ok
` HOẶC người dùng đã chọn Comfy Cloud một cách rõ ràng
- [] 
`comfy --version
` hoạt động (hoặc 
`uvx --from comfy-CLI comfy --help

)
- [] 
`curl http://HOST:PORT/system_stats
` trả về JSON
- [ ] 
`comfy model list
` hiển thị ít nhất một điểm kiểm tra (cục bộ) HOẶC
/API/experiment/models/checkpoints
` trả về các mô hình (đám mây)
- [] JSON của quy trình làm việc ở định dạng API
- [ ] 
`check_deps.py
` báo cáo 
`is_ready: true
` (hoặc chỉ 
`node_check_skipped

      trên tầng miễn phí trên đám mây)
- [ ] Chạy thử nghiệm với một quy trình làm việc nhỏ đã hoàn tất; xuất đất vào 

--output-dir
`

Siêu dữ liệu kỹ năng​

Tham khảo: đầy đủ SKILL.md​

Kỹ năng này có gì`**Tài liệu tham khảo (​

):**

, có cờ​

Khi nào nên sử dụng​

Kiến trúc: Hai lớp`​

Bắt đầu nhanh​

Phát hiện môi trường​

Siêu dữ liệu kỹ năng

Tham khảo: đầy đủ SKILL.md

Kỹ năng này có gì`**Tài liệu tham khảo (

, có cờ

Khi nào nên sử dụng

Kiến trúc: Hai lớp`

Bắt đầu nhanh

Phát hiện môi trường