> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-willie-des-1087-router-migration-block.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Comfy API v2 の概要
> 公式 Comfy API v2 リファレンス：入力をアップロードしてワークフローを送信し、結果をポーリングして外部アプリケーションから ComfyUI ワークフローを実行します。
**ベータ：** Comfy API v2 は `0.1.x` であり、API サーフェスはまだ変更される可能性があります。v2 内の変更は追加的なものになります。破壊的な変更がある場合は v3 としてリリースされます。
外部アプリケーションから ComfyUI ワークフローを実行するための、公式のバージョン管理された HTTP API です。入力のアップロード、ワークフローの送信、実行の監視、結果の取得を行うことができます。
ほとんどのユーザーは、この API を Python と TypeScript でラップした [Comfy SDK](/ja/development/api-development/sdks) から始めることをお勧めします。別の言語で開発している場合は、これらのエンドポイントを直接呼び出してください。
このセクションの API Reference ページに、OpenAPI 仕様から生成された完全なエンドポイントドキュメントがあります。
## v2 が動作する場所
同じ API は 3 つのサーフェスで提供されているため、ベース URL を変更するだけで 1 つの統合をそれらの間で移行できます。
**Comfy Cloud。** `https://cloud.comfy.org` で提供されるマネージド型のマルチテナントサービスです。[API キー](/ja/development/api-development/getting-an-api-key) を作成すれば、任意のワークフローを送信できます。クレジット、モデルの閲覧、キューの管理といった Cloud 固有の機能は v2 ではなく [v1 Cloud API](/ja/development/cloud/overview) にあります。
**Comfy API デプロイメント。** [Developer Platform](https://platform.comfy.org) を通じてデプロイした環境には、`https://{deployment}.run.comfy.app` という専用のエンドポイントが割り当てられ、同じ API キーで同じ v2 API を提供します。Comfy API デプロイメントは 1 つの固定された環境に対してワークフローを実行するため独立してスケールし、`GET /workflow` は実行されたグラフを返します。構築とデプロイの手順については、[Comfy API デプロイメントガイド](/ja/development/serverless/overview) を参照してください。
**オープンソースの ComfyUI（プロキシ経由）。** ベータ期間中、セルフホストの ComfyUI は [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) を通じて v2 を利用できます。これは ComfyUI と並行して動作する小規模なオープンソースサービスです：
```bash theme={null}
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) を参照してください。
## 設計原則
* **ポーリング優先。** すべての機能は、単純な GET ポーリングで利用できます。SSE ストリームはライブ拡張機能であり、正本（source of truth）にはなりません。
* **すべて再開可能。** 送信は冪等であり、ジョブの状態と出力は `expires_at` まで ID で取得できます。
* **コンテンツアドレス型アセット。** アセットは、サーバーが計算した blake3 ハッシュをキーとする blob 上の UUID 識別レコードです。そのため、同一の入力が 2 回アップロードされることはありません。
* **URL を組み立てず、リンクに従う。** レスポンスには後続の URL が埋め込まれています。
これらの背景にある設計上の理由については、[設計メモ](/ja/development/api-development/sdks-design) を参照してください。
## ベース URL
| サーフェス | URL | 認証 |
| -------------------------------------------------------------------------- | ------------------------------------ | --------------------------------- |
| Comfy Cloud | `https://cloud.comfy.org` | `Authorization: Bearer ` |
| Comfy API デプロイメント | `https://{deployment}.run.comfy.app` | `Authorization: Bearer ` |
| セルフホスト（[comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) 経由） | `http://127.0.0.1:8189` | デフォルトでは認証なし。オプションで静的ベアラートークンを使用可能 |
## エンドポイントのカテゴリ
| カテゴリ | 説明 |
| ---- | -------------------------------------------------------- |
| アセット | コンテンツアドレス型 blob 上の UUID 識別レコード。入力のアップロードと出力のダウンロードを行います。 |
| ジョブ | ワークフローの 1 回の実行。永続的で、ポーリング可能であり、キャンセルも可能です。 |
## Comfy Router
Comfy API v2 は、送信してポーリングする永続的なジョブとしてワークフローを実行します。モデルを直接呼び出す場合（パートナーモデル 1 つ、リクエスト 1 つ、モデル固有のネイティブな入出力）は、[Comfy Router](/ja/development/comfy-router/quickstart) をご覧ください。先に [Router の制限事項](/ja/development/comfy-router/limitations) をご確認ください。Router はまだ一般提供されていません。