+
+
+This will download a `.json` file containing only the API-relevant data:
+
+```json
+{
+ "3": {
+ "inputs": {
+ "seed": 156680208700286,
+ "steps": 20,
+ "cfg": 8,
+ "sampler_name": "euler",
+ "scheduler": "normal",
+ "denoise": 1,
+ "model": [
+ "4",
+ 0
+ ],
+ "positive": [
+ "6",
+ 0
+ ],
+ "negative": [
+ "7",
+ 0
+ ],
+ "latent_image": [
+ "5",
+ 0
+ ]
+ },
+ "class_type": "KSampler",
+ "_meta": {
+ "title": "KSampler"
+ }
+ },
+ "4": {
+ "inputs": {
+ "ckpt_name": "v1-5-pruned-emaonly-fp16.safetensors"
+ },
+ "class_type": "CheckpointLoaderSimple",
+ "_meta": {
+ "title": "Load Checkpoint"
+ }
+ },
+ "5": {
+ "inputs": {
+ "width": 512,
+ "height": 512,
+ "batch_size": 1
+ },
+ "class_type": "EmptyLatentImage",
+ "_meta": {
+ "title": "Empty Latent Image"
+ }
+ },
+ "6": {
+ "inputs": {
+ "text": "beautiful scenery nature glass bottle landscape, , purple galaxy bottle,",
+ "clip": [
+ "4",
+ 1
+ ]
+ },
+ "class_type": "CLIPTextEncode",
+ "_meta": {
+ "title": "CLIP Text Encode (Prompt)"
+ }
+ },
+ "7": {
+ "inputs": {
+ "text": "text, watermark",
+ "clip": [
+ "4",
+ 1
+ ]
+ },
+ "class_type": "CLIPTextEncode",
+ "_meta": {
+ "title": "CLIP Text Encode (Prompt)"
+ }
+ },
+ "8": {
+ "inputs": {
+ "samples": [
+ "3",
+ 0
+ ],
+ "vae": [
+ "4",
+ 2
+ ]
+ },
+ "class_type": "VAEDecode",
+ "_meta": {
+ "title": "VAE Decode"
+ }
+ },
+ "9": {
+ "inputs": {
+ "filename_prefix": "ComfyUI",
+ "images": [
+ "8",
+ 0
+ ]
+ },
+ "class_type": "SaveImage",
+ "_meta": {
+ "title": "Save Image"
+ }
+ }
+}
+```
+
+---
+
+## Converting Between Formats
+
+If you have a save-format workflow and need it in API format, the simplest method is:
+
+1. Open the `.json` file using `File → Load` in the frontend
+2. Export it via `File → Export Workflow (API)`
+
+For automated conversion, you can write a script that strips the `x`, `y`, `width` fields from each node and removes the `groups` and `extra` sections from the root JSON.
+
+---
+
+## Related Pages
+
+- [APIs Overview](/development/api-development/overview) — Compare Cloud and Server API options
+- [Cloud API Overview](/development/cloud/overview) — Submit API-format workflows to Comfy Cloud
+- [API Examples](/development/comfyui-server/api-examples) — See API-format workflows in action
+- [Getting an API Key](/development/api-development/getting-an-api-key) — Required for Cloud API and Partner Nodes
diff --git a/development/cloud/api-reference.mdx b/development/cloud/api-reference.mdx
index b70babc43..13cbf6659 100644
--- a/development/cloud/api-reference.mdx
+++ b/development/cloud/api-reference.mdx
@@ -1,6 +1,7 @@
---
title: "Cloud API Reference"
description: "Complete API reference with code examples for Comfy Cloud"
+icon: "book-open"
---
import PollJobCompletion from '/snippets/cloud/poll-job-completion.mdx'
@@ -327,7 +328,7 @@ print(f"Submitted job: {prompt_id}")
### Using Partner Nodes
-If your workflow contains [Partner Nodes](/tutorials/api-nodes/overview) (nodes that call external AI services like Flux Pro, Ideogram, etc.), you must include your Comfy API key in the `extra_data` field of the request payload.
+If your workflow contains [Partner Nodes](/tutorials/api-nodes/overview) (nodes that call external AI services like Flux Pro, Ideogram, etc.), you must include your [Comfy API key](/development/api-development/getting-an-api-key) in the `extra_data` field of the request payload.
cloud.comfy.org. Runs workflows on Cloud GPUs, uses pre-installed models, and searches the full template library.
+ generate_image, generate_video, generate_3d, and more tools across 30+ partner providers.
+ - Written by comfyanonymous and other contributors. + Written by comfyanonymous and other contributors.
Download for Windows (NVIDIA)
+Download for Windows
## ComfyUI Desktop Installation Steps @@ -63,12 +64,13 @@ Double-click the corresponding shortcut to enter ComfyUI initialization settings
+
+| # | Tool | Layer | Description |
+|---|------|-------|-------------|
+| 1 | **Mask Pen** | Mask | Primary tool for drawing mask regions. Left-click and drag to paint mask on the image. |
+| 2 | **Paint Pen** | RGB (Paint) | Paint directly onto the image's RGB layer. Useful for inpainting or touching up the base image. |
+| 3 | **Eraser** | Mask / RGB | Erase parts of an existing mask or paint layer. |
+| 4 | **Paint Bucket** | Mask | Flood-fill tool based on color similarity. Click a pixel to fill the connected region with a mask; click an already-masked area to erase from the mask. Tolerance controls how broadly the fill spreads. |
+| 5 | **Color Select** | Mask | Selectively mask all pixels matching a target color, with advanced matching algorithms (Simple HSL / LAB).
+
+---
+
+## TopBar Actions
+
+
-
+The top bar provides canvas-wide operations:
-You can then click with your mouse on the image to create and edit masks.
+| # | Action | Description |
+|---|--------|-------------|
+| 1 | **Undo** (Ctrl+Z) | Revert the last action |
+| 2 | **Redo** (Ctrl+Shift+Z / Ctrl+Y) | Reapply a reverted action |
+| 3 | **Rotate Left** | Rotate all layers 90° counter-clockwise |
+| 4 | **Rotate Right** | Rotate all layers 90° clockwise |
+| 5 | **Mirror Horizontal** | Flip all layers horizontally |
+| 6 | **Mirror Vertical** | Flip all layers vertically |
+| 7 | **Invert** | Invert the mask (black ↔ white) |
+| 8 | **Clear** | Clear the entire mask |
+| 9 | **Save** | Save the mask and close the editor |
+| 10 | **Cancel** | Close without saving |
+
+> **Note**: Rotate and mirror operations affect all three layers (mask, paint, and base image) simultaneously. GPU-accelerated textures are recreated after transforms.
+
+---
+
+## Layers
+
+The right panel includes a **Layers** section where you can toggle visibility of each layer independently:
+
+- **Mask Layer**: The mask overlay. You can adjust its **opacity** and **blending mode**:
+ - `Black` — Mask renders as black overlay
+ - `White` — Mask renders as white overlay
+ - `Negative` — Inverted mask rendering
+- **Paint Layer**: The RGB paint layer (visible when using Paint Pen)
+- **Base Image Layer**: The original source image
+
+Click **Activate Layer** on a layer to switch drawing focus to it.
+
+Refer to the main editor screenshot above — the right panel includes brush settings and the Layers section at the bottom.
+
+---
+
+## Brush Settings
+
+When a brush-based tool (Mask Pen, Paint Pen, or Eraser) is active, the side panel shows brush settings:
+
+| Setting | Range | Description |
+|---------|-------|-------------|
+| **Shape** | Arc / Rect | Round brush or square brush |
+| **Color** | Any hex color | The paint color (for Paint Pen) or mask color |
+| **Thickness** | 1–250 | Brush diameter in pixels |
+| **Opacity** | 0–1 | Brush stroke transparency |
+| **Hardness** | 0–1 | Edge softness. 1 = hard edge, 0 = very soft |
+| **Step Size** | 1–100 | Spacing between brush dabs. Lower values give smoother strokes |
+
+Use **Reset to Default** to restore the default brush parameters.
+
+---
+
+## Canvas Navigation & Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| **Space + Drag** | Pan the canvas |
+| **Ctrl + Scroll** | Zoom in/out |
+| **Click zoom %** | Reset zoom to 100% |
+| **Ctrl + Z** | Undo |
+| **Ctrl + Shift + Z** or **Ctrl + Y** | Redo |
+| **Alt + Right-click + Drag** | Adjust brush: left/right changes **size**, up/down changes **hardness** |
+
+---
+
+## Settings
+
+In the ComfyUI Settings panel, you can configure the following Mask Editor options:
+
+| Setting | Category | Default | Description |
+|---------|----------|---------|-------------|
+| **Brush adjustment speed multiplier** | Mask Editor → Brush Adjustment → Sensitivity | 1.0 (0.1–2.0) | How quickly the brush size and hardness change when using Alt+Right-click drag |
+| **Lock brush adjustment to dominant axis** | Mask Editor → Brush Adjustment → Use Dominant Axis | On | When enabled, the adjustment affects only size OR hardness based on your dominant movement direction |
+
+---
## Video Tutorial
@@ -21,3 +142,5 @@ You can then click with your mouse on the image to create and edit masks.
+
+
+これにより、API 関連データのみを含む `.json` ファイルがダウンロードされます:
+
+```json
+{
+ "3": {
+ "inputs": {
+ "seed": 156680208700286,
+ "steps": 20,
+ "cfg": 8,
+ "sampler_name": "euler",
+ "scheduler": "normal",
+ "denoise": 1,
+ "model": [
+ "4",
+ 0
+ ],
+ "positive": [
+ "6",
+ 0
+ ],
+ "negative": [
+ "7",
+ 0
+ ],
+ "latent_image": [
+ "5",
+ 0
+ ]
+ },
+ "class_type": "KSampler",
+ "_meta": {
+ "title": "KSampler"
+ }
+ },
+ "4": {
+ "inputs": {
+ "ckpt_name": "v1-5-pruned-emaonly-fp16.safetensors"
+ },
+ "class_type": "CheckpointLoaderSimple",
+ "_meta": {
+ "title": "Load Checkpoint"
+ }
+ },
+ "5": {
+ "inputs": {
+ "width": 512,
+ "height": 512,
+ "batch_size": 1
+ },
+ "class_type": "EmptyLatentImage",
+ "_meta": {
+ "title": "Empty Latent Image"
+ }
+ },
+ "6": {
+ "inputs": {
+ "text": "beautiful scenery nature glass bottle landscape, , purple galaxy bottle,",
+ "clip": [
+ "4",
+ 1
+ ]
+ },
+ "class_type": "CLIPTextEncode",
+ "_meta": {
+ "title": "CLIP Text Encode (Prompt)"
+ }
+ },
+ "7": {
+ "inputs": {
+ "text": "text, watermark",
+ "clip": [
+ "4",
+ 1
+ ]
+ },
+ "class_type": "CLIPTextEncode",
+ "_meta": {
+ "title": "CLIP Text Encode (Prompt)"
+ }
+ },
+ "8": {
+ "inputs": {
+ "samples": [
+ "3",
+ 0
+ ],
+ "vae": [
+ "4",
+ 2
+ ]
+ },
+ "class_type": "VAEDecode",
+ "_meta": {
+ "title": "VAE Decode"
+ }
+ },
+ "9": {
+ "inputs": {
+ "filename_prefix": "ComfyUI",
+ "images": [
+ "8",
+ 0
+ ]
+ },
+ "class_type": "SaveImage",
+ "_meta": {
+ "title": "Save Image"
+ }
+ }
+}
+```
+
+---
+
+## 形式の変換
+
+保存形式のワークフローを API 形式に変換する最も簡単な方法:
+
+1. フロントエンドで `File → Load` から `.json` ファイルを開く
+2. `File → Export Workflow (API)` で再エクスポート
+
+自動化が必要な場合は、各ノードの `x`、`y`、`width` フィールドを削除し、ルート JSON から `groups` と `extra` セクションを取り除くスクリプトを作成できます。
+
+---
+
+## 関連ページ
+
+- [API 概要](/ja/development/api-development/overview) — Cloud と Server API の比較
+- [Cloud API 概要](/ja/development/cloud/overview) — Comfy Cloud に API 形式のワークフローを送信
+- [API 例](/ja/development/comfyui-server/api-examples) — API 形式ワークフローの実例
+- [API Key の取得](/ja/development/api-development/getting-an-api-key) — Cloud API と Partner Nodes に必要
diff --git a/ja/development/cloud/api-reference.mdx b/ja/development/cloud/api-reference.mdx
index e6b3ffd2c..7ea11a63a 100644
--- a/ja/development/cloud/api-reference.mdx
+++ b/ja/development/cloud/api-reference.mdx
@@ -1,6 +1,7 @@
---
title: "Cloud API リファレンス"
description: "Comfy Cloud の完全な API リファレンスとコード例"
+icon: "book-open"
translationSourceHash: ef54c171
translationFrom: development/cloud/api-reference.mdx, zh/development/cloud/api-reference.mdx
translationMismatches:
@@ -405,7 +406,7 @@ prompt_id = submit_workflow_with_partner_nodes(workflow, API_KEY)
cloud.comfy.org に接続。Cloud GPU でワークフローを実行し、プリインストールモデルを使用。
+ - comfyanonymous および他の貢献者によって執筆。 + comfyanonymous および他の貢献者によって執筆。
Windows 用ダウンロード (NVIDIA)
+Windows 用ダウンロード
## ComfyUI Desktop インストール手順 @@ -65,12 +66,13 @@ ComfyUI Desktop のハードウェア要件:
+
+| # | ツール | レイヤー | 説明 |
+|---|-------|---------|------|
+| 1 | **Mask Pen** | マスクレイヤー | マスク描画の主要ツール。左クリック+ドラッグで画像上にマスクを描きます。 |
+| 2 | **Paint Pen** | ペイントレイヤー(RGB) | 画像の RGB レイヤーに直接描画します。インペイントやベース画像の修正に便利です。 |
+| 3 | **Eraser** | マスクレイヤー / ペイントレイヤー | 既存のマスクやペイントレイヤーの一部を消去します。 |
+| 4 | **Paint Bucket** | マスクレイヤー | 色の類似性に基づく塗りつぶしツール。ピクセルをクリックすると接続領域にマスクを塗りつぶします。マスク済み領域をクリックするとマスクを消去します。許容値(Tolerance)で塗りつぶしの広がりを制御します。 |
+| 5 | **Color Select** | マスクレイヤー | ターゲット色に一致する全ピクセルを選択的にマスクします。高度なマッチングアルゴリズム(Simple / HSL / LAB)に対応。 |
+
+---
+
+## TopBar 操作
+
+
-
+上部バーではキャンバス全体に対する操作が行えます:
-その後、マウスで画像上をクリックすることで、マスクの作成と編集が行えます。
+| # | 操作 | 説明 |
+|---|------|------|
+| 1 | **元に戻す**(Ctrl+Z) | 最後の操作を元に戻す |
+| 2 | **やり直し**(Ctrl+Shift+Z / Ctrl+Y) | 元に戻した操作をやり直す |
+| 3 | **左に回転** | 全レイヤーを反時計回りに 90° 回転 |
+| 4 | **右に回転** | 全レイヤーを時計回りに 90° 回転 |
+| 5 | **左右反転** | 全レイヤーを水平反転 |
+| 6 | **上下反転** | 全レイヤーを垂直反転 |
+| 7 | **反転** | マスクを反転(黒 ↔ 白) |
+| 8 | **クリア** | マスク全体をクリア |
+| 9 | **保存** | マスクを保存してエディターを閉じる |
+| 10 | **キャンセル** | 保存せずにエディターを閉じる |
+
+> **注**:回転と反転操作は 3 つのレイヤー(マスク、ペイント、ベース画像)すべてに同時に適用されます。変換後に GPU テクスチャが再作成されます。
+
+---
+
+## レイヤー
+
+右側パネル下部の **レイヤー** セクションでは、各レイヤーの表示/非表示を個別に切り替えられます:
+
+- **マスクレイヤー**:マスクオーバーレイ。**マスク不透明度**と**マスク合成オプション**を調整可能:
+ - `黒` — マスクを黒のオーバーレイとして表示
+ - `白` — マスクを白のオーバーレイとして表示
+ - `ネガティブ` — マスクを反転表示
+- **ペイントレイヤー**:RGB ペイントレイヤー(Paint Pen 使用時に表示)
+- **ベース画像レイヤー**:元のソース画像
+
+レイヤーの **レイヤーを有効化** をクリックすると、そのレイヤーに描画フォーカスが切り替わります。
+
+上のメインエディターのスクリーンショットを参照 — 右側パネルにはブラシ設定と下部のレイヤーセクションが含まれています。
+
+---
+
+## ブラシ設定
+
+ブラシベースのツール(Mask Pen、Paint Pen、Eraser)がアクティブな場合、サイドパネルにブラシ設定が表示されます:
+
+| 設定 | 範囲 | 説明 |
+|------|------|------|
+| **ブラシ形状** | Arc / Rect | 丸ブラシまたは四角ブラシ |
+| **カラーピッカー** | 任意の 16 進色 | ペイント色(Paint Pen 用)またはマスク色 |
+| **太さ** | 1–250 | ブラシ直径(ピクセル) |
+| **不透明度** | 0–1 | ブラシストロークの透明度 |
+| **硬さ** | 0–1 | エッジの柔らかさ。1 = 硬いエッジ、0 = 非常に柔らかい |
+| **ステップサイズ** | 1–100 | ブラシの打点間隔。値が低いほど滑らかなストローク |
+
+**デフォルトにリセット** でブラシパラメーターをデフォルトに戻せます。
+
+---
+
+## キャンバス操作とショートカット
+
+| ショートカット | 操作 |
+|--------------|------|
+| **Space + ドラッグ** | キャンバスのパン |
+| **Ctrl + スクロール** | ズームイン/アウト |
+| **ズーム%をクリック** | ズームを 100% にリセット |
+| **Ctrl + Z** | 元に戻す |
+| **Ctrl + Shift + Z** または **Ctrl + Y** | やり直し |
+| **Alt + 右クリック + ドラッグ** | ブラシ調整:左右で**サイズ**、上下で**硬さ**を変更 |
+
+---
+
+## 設定
+
+ComfyUI の設定パネルで、以下のマスクエディターオプションを設定できます:
+
+| 設定 | カテゴリー | デフォルト | 説明 |
+|------|-----------|-----------|------|
+| **Brush adjustment speed multiplier** | Mask Editor → Brush Adjustment → Sensitivity | 1.0 (0.1–2.0) | Alt+右クリックドラッグ時のブラシサイズ・硬さ変更速度。値が大きいほど速い |
+| **Lock brush adjustment to dominant axis** | Mask Editor → Brush Adjustment → Use Dominant Axis | オン | 有効にすると、移動の主軸方向に応じてサイズ**または**硬さのみが調整される |
+
+---
## 動画チュートリアル
\ No newline at end of file
+
+
+> **注**:この動画は旧バージョンのマスクエディター(Nodes 1.0 UI)を示しており、ブラシサイズ調整とマスクプレビュー作成の基本フローをデモンストレーションしています。現在のバージョンでも基本的なワークフローは同じです。
diff --git a/ja/interface/user.mdx b/ja/interface/user.mdx
index 9b1bc16e4..8e73b35be 100644
--- a/ja/interface/user.mdx
+++ b/ja/interface/user.mdx
@@ -13,7 +13,7 @@ import SettingsMenuContext from "/snippets/ja/interface/settings-menu-context.md
+
+
+
+### Anima Preview:アニメテキストから画像生成
+
+
+
+## Anima モデルのダウンロード
+
+すべてのモデルファイルは Hugging Face の [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima) から入手できます。
+
+
+
+### Lens Turbo
+
+Lens Turbo は蒸留版で、より少ないサンプリングステップで画像を生成し、高速な推論を実現します。
+
+
+
+## モデルダウンロード
+
+すべてのモデルファイルは Hugging Face の [Comfy-Org/Lens](https://huggingface.co/Comfy-Org/Lens) にあります。
+
+
+
+
+
+
+
+
+
+### Anima Preview: Anime Text-to-Image Generation
+
+
+
+## Anima model downloads
+
+You can find all model files at [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima) on Hugging Face.
+
+
+
+### Lens Turbo
+
+Lens Turbo is a distilled variant that generates images in fewer sampling steps for faster inference.
+
+
+
+## Lens model downloads
+
+You can find all model files at [Comfy-Org/Lens](https://huggingface.co/Comfy-Org/Lens) on Hugging Face.
+
+
+
+
+
+
+
+
+
+
+这将下载一个只包含 API 相关数据的 `.json` 文件:
+
+```json
+{
+ "3": {
+ "inputs": {
+ "seed": 156680208700286,
+ "steps": 20,
+ "cfg": 8,
+ "sampler_name": "euler",
+ "scheduler": "normal",
+ "denoise": 1,
+ "model": [
+ "4",
+ 0
+ ],
+ "positive": [
+ "6",
+ 0
+ ],
+ "negative": [
+ "7",
+ 0
+ ],
+ "latent_image": [
+ "5",
+ 0
+ ]
+ },
+ "class_type": "KSampler",
+ "_meta": {
+ "title": "KSampler"
+ }
+ },
+ "4": {
+ "inputs": {
+ "ckpt_name": "v1-5-pruned-emaonly-fp16.safetensors"
+ },
+ "class_type": "CheckpointLoaderSimple",
+ "_meta": {
+ "title": "Load Checkpoint"
+ }
+ },
+ "5": {
+ "inputs": {
+ "width": 512,
+ "height": 512,
+ "batch_size": 1
+ },
+ "class_type": "EmptyLatentImage",
+ "_meta": {
+ "title": "Empty Latent Image"
+ }
+ },
+ "6": {
+ "inputs": {
+ "text": "beautiful scenery nature glass bottle landscape, , purple galaxy bottle,",
+ "clip": [
+ "4",
+ 1
+ ]
+ },
+ "class_type": "CLIPTextEncode",
+ "_meta": {
+ "title": "CLIP Text Encode (Prompt)"
+ }
+ },
+ "7": {
+ "inputs": {
+ "text": "text, watermark",
+ "clip": [
+ "4",
+ 1
+ ]
+ },
+ "class_type": "CLIPTextEncode",
+ "_meta": {
+ "title": "CLIP Text Encode (Prompt)"
+ }
+ },
+ "8": {
+ "inputs": {
+ "samples": [
+ "3",
+ 0
+ ],
+ "vae": [
+ "4",
+ 2
+ ]
+ },
+ "class_type": "VAEDecode",
+ "_meta": {
+ "title": "VAE Decode"
+ }
+ },
+ "9": {
+ "inputs": {
+ "filename_prefix": "ComfyUI",
+ "images": [
+ "8",
+ 0
+ ]
+ },
+ "class_type": "SaveImage",
+ "_meta": {
+ "title": "Save Image"
+ }
+ }
+}
+```
+
+---
+
+## 格式转换
+
+如果你有一个保存格式的工作流需要转为 API 格式,最简单的方法是:
+
+1. 在前端通过 `文件 → 加载` 打开 `.json` 文件
+2. 通过 `文件 → 导出工作流 (API)` 重新导出
+
+如果需要自动化转换,可以编写脚本去除每个节点的 `x`、`y`、`width` 字段,并移除根 JSON 中的 `groups` 和 `extra` 部分。
+
+---
+
+## 相关页面
+
+- [API 总览](/zh/development/api-development/overview) — 比较 Cloud 和 Server API 选项
+- [Cloud API 概述](/zh/development/cloud/overview) — 向 Comfy Cloud 提交 API 格式的工作流
+- [API 示例](/zh/development/comfyui-server/api-examples) — 查看 API 格式工作流的使用示例
+- [获取 API Key](/zh/development/api-development/getting-an-api-key) — Cloud API 和 Partner Nodes 所需
diff --git a/zh/development/cloud/api-reference.mdx b/zh/development/cloud/api-reference.mdx
index c0970fcda..0dc2bcd9d 100644
--- a/zh/development/cloud/api-reference.mdx
+++ b/zh/development/cloud/api-reference.mdx
@@ -1,6 +1,7 @@
---
title: "Cloud API 参考"
description: "Comfy Cloud 的完整 API 参考及代码示例"
+icon: "book-open"
---
import PollJobCompletion from '/snippets/zh/cloud/poll-job-completion.mdx'
@@ -400,7 +401,7 @@ prompt_id = submit_workflow_with_partner_nodes(workflow, API_KEY)
cloud.comfy.org 的 MCP 服务器。在 Cloud GPU 上运行工作流,使用预装模型。
+ generate_image、generate_video 等工具,覆盖 30+ 合作提供商。
+ - 由 comfyanonymous 和其他贡献者开发。 + 由 comfyanonymous 和其他贡献者开发。
Download for Windows (NVIDIA)
+Download for Windows
## ComfyUI 桌面版安装步骤 @@ -58,12 +59,13 @@ ComfyUI 桌面版(Windows)硬件要求:
+
+| # | 工具 | 图层 | 说明 |
+|---|------|------|------|
+| 1 | **Mask Pen** | 遮罩层 | 主要遮罩绘制工具。左键拖拽在图像上绘制遮罩。 |
+| 2 | **Paint Pen** | 绘画层(RGB) | 直接在图像的 RGB 层上绘制。适用于局部重绘或原图修补。 |
+| 3 | **Eraser** | 遮罩层 / 绘画层 | 擦除已有遮罩或绘画层的部分内容。 |
+| 4 | **Paint Bucket** | 遮罩层 | 基于颜色相似性的洪水填充工具。点击像素填充连通区域创建遮罩;点击已有遮罩的区域则擦除遮罩。阈值(Tolerance)控制填充扩散范围。 |
+| 5 | **Color Select** | 遮罩层 | 选择性地遮罩与目标颜色匹配的所有像素,支持高级匹配算法(Simple / HSL / LAB)。 |
+
+---
+
+## TopBar 操作
+
+
-
+顶部栏提供了画布级别的操作:
-然后你就可以通过鼠标在图像上点击来创建和编辑遮罩了。
+| # | 操作 | 说明 |
+|---|------|------|
+| 1 | **撤回**(Ctrl+Z) | 撤回上一步操作 |
+| 2 | **重做**(Ctrl+Shift+Z / Ctrl+Y) | 重做被撤回的操作 |
+| 3 | **向左旋转** | 将所有图层逆时针旋转 90° |
+| 4 | **向右旋转** | 将所有图层顺时针旋转 90° |
+| 5 | **水平翻转** | 水平翻转所有图层 |
+| 6 | **垂直翻转** | 垂直翻转所有图层 |
+| 7 | **反转** | 反转遮罩(黑白互换) |
+| 8 | **清除** | 清除整个遮罩 |
+| 9 | **保存** | 保存遮罩并关闭编辑器 |
+| 10 | **取消** | 关闭编辑器,不保存 |
+
+> **注意**:旋转和翻转操作会同时影响所有三个图层(遮罩层、绘画层和原图层)。GPU 加速纹理会在变换后重新创建。
+
+---
+
+## 图层
+
+右侧面板底部包含 **图层** 区域,可以独立控制每个图层的显示/隐藏:
+
+- **遮罩层**:遮罩叠加层。可调整**遮罩不透明度**和**遮罩混合设置**:
+ - `黑` — 遮罩以黑色叠加显示
+ - `白` — 遮罩以白色叠加显示
+ - `负面` — 反转遮罩渲染
+- **绘画层**:RGB 绘画层(使用 Paint Pen 时可见)
+- **基础图像层**:原始源图像
+
+点击图层上的 **活跃层** 可切换绘制焦点到该图层。
+
+参照上方主界面截图 — 右侧面板包含笔刷设置和底部的图层区域。
+
+---
+
+## 笔刷设置
+
+当基于笔刷的工具(Mask Pen、Paint Pen 或 Eraser)激活时,侧边面板显示笔刷设置:
+
+| 设置项 | 范围 | 说明 |
+|--------|------|------|
+| **笔刷形状** | Arc / Rect | 圆形笔刷或方形笔刷 |
+| **色彩选取** | 任意十六进制颜色 | 绘制颜色(Paint Pen 用)或遮罩颜色 |
+| **厚度** | 1–250 | 画笔直径(像素) |
+| **不透明度** | 0–1 | 画笔笔触透明度 |
+| **硬度** | 0–1 | 边缘柔和度。1 = 硬边缘,0 = 非常柔和 |
+| **间距** | 1–100 | 画笔点之间的间距。值越低笔触越平滑 |
+
+使用 **重置为默认** 恢复默认画笔参数。
+
+---
+
+## 画布导航与快捷键
+
+| 快捷键 | 操作 |
+|--------|------|
+| **Space + 拖拽** | 平移画布 |
+| **Ctrl + 滚轮** | 放大/缩小 |
+| **点击缩放百分比** | 将缩放重置为 100% |
+| **Ctrl + Z** | 撤回 |
+| **Ctrl + Shift + Z** 或 **Ctrl + Y** | 重做 |
+| **Alt + 右键拖拽** | 调整笔刷:左右改变**大小**,上下改变**硬度** |
+
+---
+
+## 设置
+
+在 ComfyUI 的设置面板中,可以配置以下遮罩编辑器选项:
+
+| 设置项 | 分类 | 默认值 | 说明 |
+|--------|------|--------|------|
+| **Brush adjustment speed multiplier** | Mask Editor → Brush Adjustment → Sensitivity | 1.0 (0.1–2.0) | 控制 Alt+右键拖拽调整笔刷时的速度,值越大变化越快 |
+| **Lock brush adjustment to dominant axis** | Mask Editor → Brush Adjustment → Use Dominant Axis | 开启 | 开启后,调整仅基于移动的主轴方向影响大小或硬度 |
+
+---
## 演示视频
@@ -21,3 +142,5 @@ icon: "brush"
+
+
+
+### Anima Preview:动漫文生图
+
+
+
+## Anima 模型下载
+
+所有模型文件均可从 Hugging Face 的 [circlestone-labs/Anima](https://huggingface.co/circlestone-labs/Anima) 获取。
+
+
+
+### Lens Turbo
+
+Lens Turbo 是蒸馏版,只需较少的采样步数即可生成图像,推理速度更快。
+
+
+
+## 模型下载
+
+所有模型文件可在 Hugging Face 上的 [Comfy-Org/Lens](https://huggingface.co/Comfy-Org/Lens) 找到。
+
+
+
+
+
+