Comfy Cloud を初めて使う場合は、Comfy Cloud の紹介 を参照してください。このセクションでは、開発者として Comfy Cloud API を使用する方法について説明します。
クイックスタート
Comfy Cloud は Comfy SDK とそのまま連携できます。ベース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 経由でのみ利用できます。サブスクリプションの詳細は料金ページをご覧ください。