Comfy Cloud を初めて利用する場合は、Comfy Cloud の紹介 をご覧ください。このセクションでは、開発者向けに Comfy Cloud API の使用方法を説明します。
クイックスタート
Comfy Cloud は Comfy SDKs がそのまま利用できます。ベースURLはデフォルトで Comfy Cloud を指すため、必要なのは APIキー とワークフローだけです。APIアクセスには有料の Comfy Cloud サブスクリプションが必要です。無料プランには含まれていません。1
APIキーを作成
platform.comfy.org にログインしてキーを作成します。手順の詳細は APIキーを取得する を参照してください。
2
SDKをインストール
3
ワークフローをAPI形式でエクスポート
クラウドエディターでワークフローを構築・テストし、
File → Export Workflow (API) で workflow_api.json として保存します。ワークフローAPI形式 を参照してください。4
実行する
"9" はワークフローファイル内の出力ノードのIDです。入力、進行状況イベント、エラー処理については SDKガイド を参照してください。クレジットと利用方法
APIリクエストは、Comfy Cloud Web UIと同じ月額クレジットを消費します。API専用のクレジットプールはありません。各ティアに含まれるクレジット量、トップアップオプション、およびワークフローごとの実行時間上限は、UIジョブとまったく同じようにAPIジョブにも適用されます。各ティアの月額クレジット量については、料金ページ を参照してください。月の途中でクレジットが不足している場合は、アカウントのダッシュボードからトップアップを購入できます。並列実行(同時ジョブ)
APIユーザーは、前のジョブの完了を待たずに複数のワークフローを同時に送信できます。ジョブが受け付けられるとすぐに送信が返されるため、複数のジョブを進行中のままに保てます。ディスパッチャーは、サブスクリプションティアの上限までそれらを並列に実行します。現在の同時実行数については、platform.comfy.org を確認してください。 同時実行制限を超えて送信されたジョブは通常どおりキューに入り、スロットが空き次第自動的に実行されます。キュー自体がいっぱいの場合は、SDKが限られた予算内で自動的にリトライを行い、その後QueueFull を発生させます。
並列実行は現在、API経由でのみ利用できます。サブスクリプションの詳細については料金ページを参照してください。