wavespeed/seedvr2 の API リファレンスです。Comfy Router が WaveSpeed から提供しています。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。
モデル ID: wavespeed/seedvr2
エンドポイント: POST https://api.comfy.org/v2/models/wavespeed/seedvr2
- Wait for the result
- Queue and collect later
スキーマ
入力
boolean
デフォルト:"false"
有効にすると、出力は URL ではなく BASE64 文字列にエンコードされます。
string
必須
アップスケールする画像の URL。
string
デフォルト:"\"jpeg\""
出力画像のフォーマット。取り得る値:
jpeg、png、webpstring
デフォルト:"\"4k\""
出力画像の目標解像度。取り得る値:
2k、4k、8kGET /v2/models/wavespeed/seedvr2/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 つのアップスケーラーでは画像) です。また、2 つの画像 id でリクエストが enable_base64_output を設定した場合は、base64 エンコードされたバイト列そのものになります。リンクは Wavespeed 自身のもので、期限切れになります。string
必須
Wavespeed が表記した予測のターミナル状態。ここでは enum に絞り込まれていません。Router は値をそのまま転送し、ポーリングの分類器は比較前に小文字化するため、成功は
completed、succeeded、success、done のいずれかで、大文字小文字を問わず届くことがあります。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 が現在対応していないことと、代替手段。