> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-463e218.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API 概要

> ComfyUI をプログラムから操作するための様々な方法の概要

ComfyUIでは、ワークフローを実行する場所と管理するインフラストラクチャの量に応じて、複数のAPIオプションが用意されています。このページは、最適なアプローチを選択するのに役立ちます。

***

## はじめに

新しい統合には、**Comfy SDKs** と、それらが呼び出す Comfy API v2 を使用してください。v2 は新しいバージョン管理された HTTP インターフェースであり、既存の Cloud API および ComfyUI Server API と共存します。[Comfy API v2 の概要](/ja/api-reference/v2/overview) を参照してください。同じコードが Comfy Cloud と自分のマシンの両方に対して動作します。

<Card title="Comfy SDKs" icon="code" href="/ja/development/api-development/sdks">
  独自アプリケーションからワークフローを実行するための公式の Python および TypeScript SDK。現在ベータ版です。
</Card>

以下の他の API も引き続き完全にサポートされており、SDK がまだ対応していない領域をカバーしています。ここにあるものはどれも非推奨ではありません。

***

## どのAPIを使うべきか？

|              | Comfy API v2 + SDKs                                            | Cloud API                         | ComfyUI Server API                    |
| ------------ | -------------------------------------------------------------- | --------------------------------- | ------------------------------------- |
| **実行場所**     | Comfy Cloud、またはローカルプロキシ経由の自分のマシン                               | Comfy Cloud（管理されたGPU）             | 自分のマシン                                |
| **互換性**      | バージョン管理されており、v2内での追加変更のみ                                       | 実験的、予告なく変更される場合があります              | リリース間での保証はありません                       |
| **GPU管理**    | 接続先によって異なります                                                   | 代わりに管理されます                        | 自分のハードウェアを管理します                       |
| **モデル**      | 接続先によって異なります                                                   | Comfyによってインストール済みであり、管理されています     | ローカルでダウンロードして管理します                    |
| **認証**       | クラウドでは`Authorization: Bearer`。セルフホストはデフォルトでなし、オプションで静的ベアラートークン | `X-API-Key`ヘッダー（Comfy Cloudアカウント） | なし（ローカル）またはパートナーノード用のAPIキー            |
| **ベースURL**   | `https://cloud.comfy.org` または `http://127.0.0.1:8189`          | `https://cloud.comfy.org`         | 自分のサーバーURL（例：`http://localhost:8188`） |
| **公式クライアント** | PythonおよびTypeScript SDK                                        | なし、HTTPで直接呼び出し                    | なし、HTTPで直接呼び出し                        |
| **プロトコル**    | REST + SSE                                                     | REST + WebSocket                  | REST + WebSocket                      |
| **スコープ**     | ワークフローを実行して結果を取得                                               | モデルとアカウントを含むクラウドの全機能              | キューとノード情報を含むローカルの全機能                  |
| **最適な用途**    | 継続的に動作する必要がある新規インテグレーション                                       | SDKがまだカバーしていないクラウド機能              | フルコントロール、カスタムハードウェア＆モデル               |

これらのAPIはすべて同じワークフロー形式（[API形式](/ja/development/api-development/workflow-api-format)）を使用しているため、ワークフローをローカルで開発・テストし、変更なしでクラウドに移行できます。

***

## 開始方法

<CardGroup cols={2}>
  <Card title="Comfy SDK" icon="code" href="/ja/development/api-development/sdks">
    PythonまたはTypeScriptから、クラウドまたは自分のマシンに対してワークフローを実行します。
  </Card>

  <Card title="クラウドAPI" icon="cloud" href="/ja/development/cloud/overview">
    Comfyのマネージドインフラストラクチャ上でワークフローを実行します。GPUのセットアップは必須ではありません。
  </Card>

  <Card title="ComfyUIサーバーAPI" icon="server" href="/ja/development/comfyui-server/comms_overview">
    ComfyUIを自分のマシンでサーバーとして実行し、API経由で呼び出します。
  </Card>

  <Card title="パートナーノードAPI連携" icon="key" href="/ja/development/comfyui-server/api-key-integration">
    ヘッドレスまたはAPI駆動のワークフローで有料のパートナーノードを使用します。
  </Card>
</CardGroup>

***

## 前提条件

APIを使用する前に、以下のものが必要です：

* Comfy Cloudまたはパートナーノードに関わるすべてのものにはAPIキーが必要です（[APIキーの取得](/ja/development/api-development/getting-an-api-key) を参照）。完全にローカルなComfyUIには必要ありません。