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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 13 additions & 12 deletions ja/development/api-development/sdks.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,13 @@ title: "Comfy SDK:ComfyUI 向け Python・TypeScript クライアント"
description: "Comfy Cloud、デプロイ環境、または自前の ComfyUI に対して Python または TypeScript から ComfyUI ワークフローを実行し、アセット、ジョブ、ライブイベント、冪等なリトライを扱います。"
sidebarTitle: "SDK"
icon: "code"
translationSourceHash: dbb2e0a8
translationSourceHash: fd912955
translationFrom: development/api-development/sdks.mdx
translationBlockHashes:
"_intro": c92c7b51
"Install": da9a0a57
"Quickstart": 02297586
"Choosing a base URL": 2265e6f6
"Choosing a base URL": 0e77e81c
"Retrying a submit: the idempotency key": 7c83d78f
"Watching a job run": 34d74bcc
"Tracing an output back to its workflow": b01886a3
Expand All @@ -21,6 +21,7 @@ translationBlockHashes:




import SdkSurfaces from "/snippets/ja/sdk/surfaces.mdx";
import SdkVersions from "/snippets/ja/sdk/versions.mdx";

Expand Down Expand Up @@ -110,20 +111,20 @@ await job.getOutputs("9")[0].toFile("out.png");

## ベースURLの選択

| 接続先 | Base URL | APIキー |
| 接続先 | ベースURL | APIキー |
|---|---|---|
| **Comfy Cloud** | `https://cloud.comfy.org` (デフォルト) | 必須 |
| **Comfy API デプロイ** | `https://<deployment>.run.comfy.app` | 必須 |
| **ご自身のComfyUI** | `http://127.0.0.1:8189` (ローカルプロキシ) | デフォルトでは不要。オプションの静的ベアラートークン |
| **ご自身のComfyUI** | `http://127.0.0.1:8189` (ローカルプロキシ) | デフォルトでは不要。任意で静的なベアラートークンを指定できます。 |

ベースURLはコンストラクタ引数ではなく、`COMFY_BASE_URL`環境変数から取得されます:
ベースURLはコンストラクタの引数ではなく、`COMFY_BASE_URL`環境変数から取得されます:

```bash
export COMFY_BASE_URL="https://<deployment>.run.comfy.app" # Comfy API デプロイ
export COMFY_BASE_URL="http://127.0.0.1:8189" # セルフホストプロキシ
```

この変数はクライアントが構築されるたびに読み取られ、`http(s)` URLである必要があります。未設定または空白の場合はComfy Cloudを意味します。したがって、クライアント自体はどこでも同じです:
この変数はクライアントを構築するたびに読み取られ、`http(s)` URLである必要があります。未設定または空白の場合はComfy Cloudとみなされます。そのため、クライアント自体はどこでも同じです:

<CodeGroup>
```python Python
Expand All @@ -136,36 +137,36 @@ const client = new Comfy({ apiKey: "comfyui-..." });
</CodeGroup>

<Note>
初期ビルドからアップグレードしますか? `Comfy("<url>", "<key>")`は、`COMFY_BASE_URL`を設定した`Comfy(api_key="<key>")`になりました。`api_key`はキーワード専用引数なので、以前の位置引数での呼び出しは、URLをキーとして静かに読み取るのではなく、`TypeError`を発生させます。
以前のビルドからアップグレードする場合、`Comfy("<url>", "<key>")`は、`COMFY_BASE_URL`を設定した上で`Comfy(api_key="<key>")`に変更されています。`api_key`はキーワード専用引数なので、以前の位置引数での呼び出しは、URLをキーとして暗黙のうちに読み取るのではなく、`TypeError`を発生させます。
</Note>

### Comfy Cloud

そのまま動作します。[APIキー](/ja/development/api-development/getting-an-api-key)を作成し、クライアントに渡します。

<Note>
APIアクセスには有料のComfy Cloudサブスクリプションが必要です。無料プランには含まれません。同時に実行できるジョブ数はプランによって異なります。[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。
APIアクセスには有料のComfy Cloudサブスクリプションが必要です。無料プランには含まれません。同時に実行できるジョブ数はプランによって異なります。詳しくは[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。
</Note>

<a id="serverless-deployment"></a>

### Comfy API デプロイ

[開発者プラットフォーム](https://platform.comfy.org)を通じてデプロイしたワークフローには、専用のエンドポイントが割り当てられます。`COMFY_BASE_URL`をそのエンドポイントに指定し、Comfy Cloudとまったく同じようにAPIキーを使用します。このガイドのすべてが同じように機能します。ただし、[ジョブのラベルとジョブ一覧](#ジョブにラベルを付けて後で見つける)は Comfy Cloud ではまだサポートされていません。
[開発者プラットフォーム](https://platform.comfy.org)を通じてデプロイしたワークフローには、専用のエンドポイントが割り当てられます。`COMFY_BASE_URL`をそのエンドポイントに設定し、Comfy Cloudとまったく同じようにAPIキーを使用します。このガイドの内容はすべて同じように機能します。ただし、[ジョブのラベルとジョブ一覧](#ジョブにラベルを付けて後で見つける)はComfy Cloudではまだサポートされていません。

Comfy APIデプロイは、そのBuildに含まれるモデルとカスタムノードを使用して複数のワークフローを実行できます。各ジョブについて、`get_workflow()`は`format: "api"`を持ち、実行されたグラフを`.graph`プロパティに含むワークフローレスポンスを返します。
Comfy API デプロイでは、そのBuildに含まれるモデルとカスタムノードを使用して複数のワークフローを実行できます。各ジョブについて、`get_workflow()`は`format: "api"`を持ち、実行されたグラフを`.graph`プロパティに含むワークフローレスポンスを返します。

### ご自身のComfyUI

セルフホスト環境では、v2 API は ComfyUI と一緒に動作する小規模なオープンソースサービス [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) によって提供されます。インストールして実行し、`COMFY_BASE_URL="http://127.0.0.1:8189"`を設定します:
セルフホストのComfyUIでは、v2 APIは、ComfyUIと並行して動作する小規模なオープンソースサービスである[comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)によって提供されます。これをインストールして実行し、`COMFY_BASE_URL="http://127.0.0.1:8189"`を設定します:

```bash
pip install comfy-api-proxy
comfy-api-proxy
export COMFY_BASE_URL="http://127.0.0.1:8189"
```

設定と認証については、[セルフホスト ComfyUI 用 API プロキシ](/ja/development/comfyui-server/api-proxy)を参照してください。
設定と認証の詳細については、[セルフホストComfyUI用APIプロキシ](/ja/development/comfyui-server/api-proxy)を参照してください。

## 送信のリトライ: 冪等キー

Expand Down
5 changes: 3 additions & 2 deletions ja/development/cloud/api-reference.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
title: "Cloud API リファレンス"
description: "Comfy Cloud の完全な API リファレンスとコード例"
icon: "book-open"
translationSourceHash: 9dfb0617
translationSourceHash: e15f0e0e
translationFrom: development/cloud/api-reference.mdx
translationBlockHashes:
"_intro": 1729f5d3
"Setup": 311034bb
"Object Info": 7b62a397
"Uploading Inputs": 92df17f8
"Running Workflows": d6ddd0b4
"Running Workflows": 2c6519c7
"Checking Job Status": d74b4922
"WebSocket for Real-Time Progress": 02c49b4a
"Downloading Outputs": 5e1d63d3
Expand All @@ -19,6 +19,7 @@ translationBlockHashes:
---



import PollJobCompletion from '/snippets/ja/cloud/poll-job-completion.mdx'
import WebSocketProgress from '/snippets/ja/cloud/websocket-progress.mdx'
import DownloadOutputs from '/snippets/ja/cloud/download-outputs.mdx'
Expand Down
Loading
Loading