Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions ja/agent-tools/mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@




<Info>
**パブリックベータ。** Comfy MCP はパブリックベータ版です。API、ツール、動作は開発中に変更される可能性があります。問題の報告や提案の共有については [フィードバック](#フィードバック) をご覧ください。
</Info>
Expand Down Expand Up @@ -197,7 +198,7 @@
</Tab>

<Tab title="Codex">
[Codex](https://developers.openai.com/codex/cli) は Streamable HTTP 経由で Comfy Cloud に接続します。Settings でサーバーを追加し、OAuth でサインインします。

Check warning on line 201 in ja/agent-tools/mcp.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

ja/agent-tools/mcp.mdx#L201

Did you really mean 'Streamable'?

<video
controls
Expand Down Expand Up @@ -537,7 +538,7 @@
これにより `comfy-mcp` コンソールスクリプトが `PATH` 上に追加されます。そのコマンドが MCP サーバーです(stdio 経由で MCP を扱います)。下記で AI クライアントをそれに接続します。

<Note>
**`COMFY_BIN`(オプション)。** MCP クライアントはサーバーを独自の環境で起動しますが、その環境には通常、シェルの `PATH` が**含まれていません**。`comfy` が virtualenv や標準的でない場所にある場合は、`COMFY_BIN` にその絶対パスを設定してください(例:`/path/to/venv/bin/comfy`)。以下のすべてのクライアント例で設定場所を示しています。クライアントがサーバーを起動する環境で `comfy` が既に利用可能なら、この設定は不要です。

Check warning on line 541 in ja/agent-tools/mcp.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

ja/agent-tools/mcp.mdx#L541

Did you really mean 'virtualenv'?
</Note>

---
Expand Down
5 changes: 3 additions & 2 deletions ja/agent-tools/partner-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "Comfy Partner MCP"
description: "ローカルで動作する MCP サーバー。30以上のパートナープロバイダー(BFL、Ideogram、Kling、Runway、Veo、Meshy、ElevenLabs など)に対応した統一生成ツールを提供。"
sidebarTitle: "Partner MCP"
icon: "plug"
translationSourceHash: 5bf7f8c0
translationSourceHash: ecf72ee2
translationFrom: agent-tools/partner-mcp.mdx
translationBlockHashes:
"_intro": a7191a40
Expand All @@ -13,10 +13,11 @@ translationBlockHashes:
"Environment Variables": adce61c2
"Available Tools": 9dc9a92d
"Example Prompts": 8c35cf5b
"Related": c8ca08cc
"Related": 6f4e604e
---



<Warning>
**プライベートテスト中 — まだ公開されていません。** Comfy Partner MCP サーバーは現在プライベートテスト中です。機能や API は変更される可能性があります。アクセスは招待されたパートナーに限定されています。
</Warning>
Expand Down
59 changes: 42 additions & 17 deletions ja/api-reference/v2/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,41 +1,66 @@
---
title: "Comfy API v2 の概要"
description: "公式 Comfy API v2 リファレンス:入力をアップロードしてワークフローを送信し、結果をポーリングして外部アプリケーションから ComfyUI ワークフローを実行します。"
translationSourceHash: 6c26a24e
sidebarTitle: "概要"
description: "公式 Comfy API v2 リファレンス:入力をアップロードしてジョブを送信し、結果をポーリングして外部アプリケーションから ComfyUI ワークフローを実行します。"
translationSourceHash: f2a20d1e
translationFrom: api-reference/v2/overview.mdx
translationBlockHashes:
"_intro": faa93edf
"Where v2 Runs": 832a785d
"Design Principles": 7fb3bede
"Base URLs": 5ec95f1e
"Endpoint Categories": cfe96710
"Comfy Router": 56778843
---

<Warning>
**ベータ** Comfy API v2 は `0.1.x` であり、API サーフェスはまだ変更される可能性があります。v2 内の変更は追加的なものになります。破壊的な変更がある場合は v3 としてリリースされます。
**ベータ:** Comfy API v2 は `0.1.x` であり、API のインターフェースはまだ変更される可能性があります。v2 内の変更は追加的なものになります。破壊的な変更は v3 としてリリースされます。
</Warning>

外部アプリケーションから ComfyUI ワークフローを実行するための、公式のバージョン管理された HTTP API です。入力のアップロード、ワークフローの送信、実行の監視、結果の取得を行うことができます。

ほとんどのユーザーは、この API を Python と TypeScript でラップした [Comfy SDK](/ja/development/api-development/sdks) から始めることをお勧めします。別の言語で開発している場合は、これらのエンドポイントを直接呼び出してください。
ほとんどのユーザーは、この API を Python と TypeScript でラップした [Comfy SDKs](/ja/development/api-development/sdks) から始めることをお勧めします。他の言語で作業している場合は、これらのエンドポイントを直接呼び出してください。完全なエンドポイントドキュメントは、このセクションの API Reference ページにあり、OpenAPI 仕様から生成されています。

## v2 が動作する場所

同じ API が 3 つのサーフェスで提供されるため、1 つのインテグレーションでベース URL を変更するだけで、それらを切り替えることができます。

**Comfy Cloud.** `https://cloud.comfy.org` で提供されるマネージド型のマルチテナントサービスです。[APIキー](/ja/development/api-development/getting-an-api-key)を作成すれば、任意のワークフローを送信できます。クレジット、モデルの閲覧、キュー管理などのクラウド固有の機能は、v2 ではなく [v1 Cloud API](/ja/development/cloud/overview) にあります。

**Serverless API(Developer Platform).** [Developer Platform](https://platform.comfy.org) を通じてデプロイしたワークフローには、`https://{deployment}.run.comfy.app` に専用のエンドポイントが割り当てられ、同じ APIキーで同じ v2 API を提供します。サーバーレスデプロイメントはピン留めされた 1 つのワークフローを実行するため、独立してスケーリングされ、`GET /workflow` は実行されたグラフを返します。構築とデプロイの詳細については、[Serverless API ガイド](/ja/development/serverless/overview) を参照してください。

Check warning on line 29 in ja/api-reference/v2/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

ja/api-reference/v2/overview.mdx#L29

Did you really mean 'Serverless'?

**オープンソースの ComfyUI(プロキシ経由).** ベータ期間中、セルフホストの ComfyUI は、[comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)(ComfyUI と一緒に実行される小さなオープンソースサービス)を通じて v2 を利用します。

```bash
pip install comfy-api-proxy
comfy-api-proxy
```

デフォルトでは、`127.0.0.1:8188` の ComfyUI をプロキシし、`127.0.0.1:8189` で v2 API を提供します。ループバックのみにバインドされます。認証はデフォルトではオフになっており、オプションで静的ベアラートークンを設定できます。プロキシは暫定的な対策です。v2 が安定化すると ComfyUI コアに組み込まれ、プロキシは不要になります。設定の詳細については、SDK ガイドの [自分専用の ComfyUI](/ja/development/api-development/sdks#ご自身のcomfyui) を参照してください。

## 設計原則

- **ポーリング優先。** すべての機能は、単純な GET ポーリングで利用できます。SSE ストリームはライブ拡張機能であり、正本(source of truth)にはなりません
- **すべて再開可能。** 送信は冪等であり、ジョブの状態と出力は `expires_at` まで ID で取得できます
- **コンテンツアドレス型アセット。** アセットは、サーバーが計算した blake3 ハッシュをキーとする blob 上の UUID 識別レコードです。そのため、同一の入力が 2 回アップロードされることはありません。
- **URL を組み立てず、リンクに従う。** レスポンスには後続の URL が埋め込まれています。
- **ポーリング優先。** すべての機能は、単純な GET ポーリングで利用できます。SSE ストリームはライブ拡張であり、決して真実のソースではありません
- **すべてが再開可能。** 送信は冪等であり、ジョブの状態と出力は `expires_at` まで ID によって取得できます
- **コンテンツアドレス型アセット。** アセットは UUID で識別されるレコードであり、その基盤となる blob はサーバーが計算した blake3 ハッシュをキーとします。そのため、同一の入力が 2 回アップロードされることはありません。
- **リンクを辿り、URL を組み立てない。** レスポンスには、フォローアップ URL が埋め込まれています。

これらの背景にある設計上の理由については、[設計メモ](/ja/development/api-development/sdks-design) を参照してください。
これらの根拠については、[設計ノート](/ja/development/api-development/sdks-design) を参照してください。

## ベース URL
## ベースURL

| サーフェス | URL | 認証 |
| 利用形態 | URL | 認証 |
|---------|-----|----------------|
| Comfy Cloud | `https://cloud.comfy.org` | `Authorization: Bearer <api-key>` |
| セルフホスト([comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) 経由) | `http://127.0.0.1:8189` | デフォルトでは認証なし。オプションで静的ベアラートークンを使用可能 |
| サーバーレスデプロイメント | `https://{deployment}.run.comfy.app` | `Authorization: Bearer <api-key>` |
| セルフホスト([comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) 経由) | `http://127.0.0.1:8189` | デフォルトでは認証なし。静的ベアラートークンは任意 |

## エンドポイントのカテゴリ
## エンドポイントカテゴリ

| カテゴリ | 説明 |
|----------|-------------|
| アセット | コンテンツアドレス型 blob 上の UUID 識別レコード。入力のアップロードと出力のダウンロードを行います。 |
| ジョブ | ワークフローの 1 回の実行。永続的で、ポーリング可能であり、キャンセルも可能です。 |
| アセット | コンテンツアドレス指定されたblob上でUUIDにより識別されるレコード。入力のアップロード、出力のダウンロードを行います。 |
| ジョブ | ワークフローの1回の実行。永続的で、ポーリング可能かつキャンセル可能です。 |

## Comfy Router

Comfy API v2 は、送信してポーリングする永続的なジョブとしてワークフローを実行します。モデルを直接呼び出す場合(パートナーモデル 1 つ、リクエスト 1 つ、モデル固有のネイティブな入出力)は、[Comfy Router](/ja/api-reference/comfy-router/quickstart) をご覧ください。先に [Router の制限事項](/ja/api-reference/comfy-router/limitations) をご確認ください。Router はまだ一般提供されていません
Comfy API v2 は、送信してポーリングする永続的なジョブとしてワークフローを実行します。直接モデル呼び出し(1つのパートナーモデル、1つのリクエスト、モデル独自の入力と出力)については、[Comfy Router](/ja/api-reference/comfy-router/quickstart)を参照してください。まず[Routerの制限事項](/ja/api-reference/comfy-router/limitations)を確認してください。Routerはまだ一般提供されていません
5 changes: 3 additions & 2 deletions ja/basic-concepts/models.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@
title: "モデル"
description: "ComfyUI のモデルファイル:配置場所、ノードでの使い方、よくある問題。"
icon: "cube"
translationSourceHash: 8af18a80
translationSourceHash: bf9e2496
translationFrom: basic-concepts/models.mdx
translationBlockHashes:
"_intro": 4250b37b
"Models in plain terms": 52864462
"Models in plain terms": 0218127d
"Use models in ComfyUI": 12a2c06a
"Beyond the main checkpoint": 7d0b4849
"Uninstalling models": 00257b00
Expand All @@ -15,6 +15,7 @@
---



import ExternalModels from "/snippets/ja/install/add-external-models.mdx"

## モデルをひと言で言うと
Expand Down Expand Up @@ -44,7 +45,7 @@

- **LoRA**: スタイル、キャラクター、概念に合わせてチューニングされた軽量アドオン
- **ControlNet**: エッジ、深度、ポーズなどによる追加ガイダンス
- **Inpainting**: 既存画像内の領域の塗りつぶしや置き換え

Check warning on line 48 in ja/basic-concepts/models.mdx

View check run for this annotation

Mintlify / Mintlify Validation (dripart) - vale-spellcheck

ja/basic-concepts/models.mdx#L48

Did you really mean 'Inpainting'?

![補助モデル](/images/concepts/core-concepts_auxiliary-model.png)

Expand Down
6 changes: 5 additions & 1 deletion ja/custom-nodes/intro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,14 @@
title: "カスタムノード"
sidebarTitle: "概要"
description: "ComfyUI カスタムノードの構築、拡張、公開に適切なパスを選択します。"
translationSourceHash: 86b7348f
translationSourceHash: e3c6bea6
translationFrom: custom-nodes/intro.mdx
---

<Note>
このセクションでは、カスタムノードの開発方法のみを説明します。カスタムノードの使用方法については、はじめるセクションの [カスタムノードのインストール](/ja/installation/install_custom_node) を参照してください。
</Note>

カスタムノードは、新しいサーバーサイドの動作、ユーザーインターフェイス機能、および統合機能を追加することで ComfyUI を拡張します。やろうとしていることに応じてパスを選択してください。

<CardGroup cols={2}>
Expand Down
Loading