Skip to main content
Comfy Router が Bria から提供する bria/image-edit-erase の API リファレンスです。

Quick start

Create a key in your Comfy workspace and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP. Model ID: bria/image-edit-erase Endpoint: POST https://api.comfy.org/v2/models/bria/image-edit-erase

スキーマ

入力

string
必須
編集する画像。サポートされる入力タイプは Base64 エンコードされた文字列、または公開アクセス可能な画像ファイルを指す URL です。対応フォーマットは JPEG、JPG、PNG、WEBP です。
string
必須
削除する領域を定義するマスク。Base64 エンコードされた文字列、または公開アクセス可能な画像ファイルを指す URL です。白いピクセル (255) は削除する領域を示し、黒いピクセル (0) は保持されます。
string
指定するマスクのタイプ。“manual”(デフォルト)または “automatic” のいずれかです。
boolean
入力画像の部分的に透明な領域を出力に保持するかどうかを制御します。
boolean
false(デフォルト)の場合、リクエストは非同期で処理されます。true の場合、API は完了するまで接続を開いたままにします。
boolean
有効にすると、入力ビジュアルにコンテンツモデレーションを適用します。画像がモデレーションに失敗した場合は 422 を返します。
boolean
有効にすると、結果のビジュアルにコンテンツモデレーションを適用します。出力がモデレーションに失敗した場合は 422 を返します。
Router が GET /v2/models/bria/image-edit-erase/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる同一のドキュメントです。

出力

object
エラーオブジェクト(ステータスが ERROR の場合にのみ存在)
integer
エラーコード。
string
追加のエラー詳細。
string
エラーメッセージ。
string
リクエストの一意の識別子。
object
結果オブジェクト(ステータスが COMPLETED の場合にのみ存在)
string
生成または編集された画像の URL。
string
オリジナルのプロンプト。
string
プロンプトを洗練したバージョン。COMPLETED の生成で Bria が洗練しなかった場合は null。このキーは省略されるのではなく null を保持して存在するため Nullable です。bria/image-edit-gen-fill で実際に確認されています。
integer
生成に使用されたシード。
string
詳細な JSON 構造化プロンプト。
string
生成されたビデオの URL。
string
リクエストの現在のステータス。取り得る値: IN_PROGRESSCOMPLETEDERRORUNKNOWN

入力

出力

出荷前の確認

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

ヘッダー

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

Router API の利用

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

制限事項

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