wavespeed/flashvsr の API Reference。Comfy Router が WaveSpeed から提供します。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、生の HTTP で同じ呼び出しを行うものです。
モデル ID: wavespeed/flashvsr
エンドポイント: POST https://api.comfy.org/v2/models/wavespeed/flashvsr
- Wait for the result
- Queue and collect later
スキーマ
入力
number
必須
ビデオの再生時間(秒)
string
デフォルト:"\"1080p\""
アップスケール先の解像度。指定可能な値:
720p, 1080p, 2k, 4kstring
必須
アップスケールするビデオ。ビデオファイルへの URL、または base64 エンコードされたビデオを指定できます。
GET /v2/models/wavespeed/flashvsr/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 は値をそのまま転送し、ポーリングの分類器は比較前に小文字化するため、成功は
completed、succeeded、success、done のいずれの形でも、大文字小文字を問わず正当に到着し得ます。object
Wavespeed 独自のタイミング測定値。
integer
推論時間(ミリ秒)。Wavespeed の数値であり、Comfy の課金時間ではありません。
object
予測に対する Wavespeed 独自のリンク。
string
Router がポーリングした予測結果の URL。
string
エンベロープのステータスメッセージ。例えば
success。例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。