Skip to main content
Comfy Router が Beeble から提供する beeble/switchx の API リファレンスです。

クイックスタート

あなたの Comfy ワークスペース でキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL スニペットは、同じ呼び出しを生の HTTP で実行するものです。 モデル ID: beeble/switchx エンドポイント: POST https://api.comfy.org/v2/models/beeble/switchx

スキーマ

入力

string
必須
アルファモード: auto、fill、custom、または select指定可能な値: autofillcustomselect
string
カスタムアルファマットの URI。alpha_mode が custom または select の場合に必須です。auto または fill では無視されます。
string
完了または失敗時に webhook 通知を受け取るための HTTPS URL。
string
必須
出力タイプ: 画像またはビデオ指定可能な値: imagevideo
string
安全な再試行のための冪等性キー。同じキーのジョブがすでにアカウントに存在する場合、API は複製を作成せずに既存のジョブのステータスを返します。
integer
デフォルト:"1080"
最大出力解像度: 720 または 1080 (デフォルト: 1080)。
string
希望する出力のテキスト説明 (最大 2,000 文字)。prompt または reference_image_uri の少なくとも1つが必須です。
string
スタイル転送用の参照画像の URI。source_uri と同じ URI タイプを受け付けます。
string
必須
ソース画像またはビデオの URI。beeble://uploads/{id}/{filename}、https URL、または data:{mime};base64 URI を受け付けます (最大 50 MB)。
Router が GET /v2/models/beeble/switchx/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。

出力

string
auto、fill、custom、または select
string
ジョブが完了または失敗したときの ISO 8601 タイムスタンプ。
string
ジョブが作成されたときの ISO 8601 タイムスタンプ。
string
エラーメッセージ (status が failed の場合に存在します)。
string
画像またはビデオ
string
必須
ジョブ識別子 (swx_…)
string
最後のステータス変更の ISO 8601 タイムスタンプ。
object
SwitchX ジョブの出力に対する署名付き URL。
string
アルファマットの URL。
string
合成済み出力の URL。
string
前処理済みソースの URL。
integer
進行状況のパーセンテージ (0~100)。
string
必須
現在のジョブステータス。指定可能な値: in_queueprocessingcompletedfailed
object
SwitchX ジョブの webhook 配信ステータス。
integer
これまでの配信試行回数。
string
最後に失敗した配信試行のエラーメッセージ。
string
pending、delivered、または failed

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。