Skip to main content
wavespeed/ultimate-image-upscaler の API リファレンスです。Comfy Router が WaveSpeed から提供しています。

クイックスタート

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

スキーマ

入力

boolean
デフォルト:"false"
有効にすると、出力は URL ではなく BASE64 文字列にエンコードされます。
string
必須
アップスケールする画像の URL。
string
デフォルト:"\"jpeg\""
出力画像のフォーマット。指定可能な値: jpegpngwebp
string
デフォルト:"\"4k\""
出力画像の目標解像度。指定可能な値: 2k4k8k
Router が GET /v2/models/wavespeed/ultimate-image-upscaler/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。

出力

integer
WavespeedAI 独自のエンベロープステータスコードで、HTTP ステータスを反映します(このスキーマが記述するドキュメントでは 200)。Wavespeed は一部の失敗をトランスポートステータスではなくここで報告します。
object
必須
string
Wavespeed が予測を作成した日時の ISO-8601 タイムスタンプ。
string
Wavespeed の自由記述による失敗理由で、存在しない場合は空文字列です。実際に失敗した予測は、このドキュメントとしてではなく Comfy Router のエラーとして Router の呼び出し元に届きます。
string
Router が送信してポーリングした予測に対する Wavespeed の識別子。
string
予測の実行に使用された Wavespeed モデル ID。
string[]
必須
完成した生成物。Router が返すドキュメントでは存在し、空ではありません。このリストが結果そのものです。各要素は生成されたコンテンツへの URL(wavespeed/flashvsr では MP4、2 つのアップスケーラーでは画像)です。あるいは、リクエストで enable_base64_output を設定した場合、2 つの画像 ID については base64 エンコードされたバイト列そのものになります。これらのリンクは Wavespeed 自身のものであり、有効期限があります。
string
必須
Wavespeed が表記したとおりの予測のターミナル状態。ここでは enum に絞り込まれていません。Router は値をそのまま転送し、ポーリングの分類器は比較の前に小文字化するため、成功は completedsucceededsuccessdone のいずれとしても、大文字小文字を問わず正規に到着し得ます。
object
Wavespeed 独自の所要時間測定値。
integer
ミリ秒単位の推論時間。Comfy の課金ではなく Wavespeed の数値です。
object
予測に対する Wavespeed 独自のリンク。
string
Router がポーリングした予測結果の URL。
string
エンベロープのステータスメッセージ(例: success)。

入力

出力

出荷前の確認

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

ヘッダー

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

Router API の利用

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

制限事項

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