xai/grok-imagine-video-1.5-lite の API リファレンスです。xAI から Comfy Router が提供しています。
入力: テキスト, 画像 · 出力: ビデオ
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk と npm install @comfyorg/sdk)を使用しています。cURL スニペットは同じ呼び出しを生の HTTP で行うものです。
モデル ID: xai/grok-imagine-video-1.5-lite
エンドポイント: POST https://api.comfy.org/v2/models/xai/grok-imagine-video-1.5-lite
- 結果を待つ
- キューに入れて後で収集する
同じボディを
POST https://api.comfy.org/v2/models/xai/grok-imagine-video-1.5-lite/requests に送信します。Router は実行が受け付けられるとすぐに request_id とともに 201 を返し、結果は準備ができ次第、このプロセスからでも別のプロセスからでも収集できます。キュー配信では、status、キャンセル、収集について順を追って説明します。スキーマ
入力
string
デフォルト:"\"16:9\""
生成されるビデオのアスペクト比取り得る値:
1:1、16:9、9:16、4:3、3:4、3:2、2:3integer
デフォルト:"8"
ビデオの再生時間(秒)。範囲 [1, 15]。デフォルト 8。範囲:
1 から 15object
xAI エンドポイント用の入力画像オブジェクト
string
画像入力のタイプ取り得る値:
image_urlstring
必須
入力画像の URL(公開 URL または base64 でエンコードされたデータ URI)
string
使用するモデル。対応: grok-imagine-video(デフォルト)、grok-imagine-video-1.5-preview、grok-imagine-video-1.5、grok-imagine-video-1.5-lite。非推奨の grok-imagine-video-beta id は grok-imagine-video のエイリアスです。
object
生成されたビデオの任意の出力先
string
必須
ビデオ生成のためのプロンプト。最大 4,096 文字。
object[]
ビデオ生成を導くための 1 つ以上の参照画像(参照から動画モード)。image とは同時に指定できません。Router は application/json のみを転送し、このオブジェクトも XAIImageObject も file_id を受け付けないため、このルートではファイルベースの画像入力はサポートされません。
string
必須
参照画像の URL。HTTPS URL(公開)または base64 でエンコードされたデータ URL(例: data:image/jpeg;base64,…)をサポートします。
string
出力ビデオの解像度
string
出力ビデオのサイズ
string
エンドユーザーを表す一意の識別子
GET /v2/models/xai/grok-imagine-video-1.5-lite/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる同じドキュメントです。
出力
string
リクエストが入力モデレーションによってブロックされた場合、ブロック理由が含まれます
string
ビデオの生成に使用されたモデル
string
遅延リクエストのステータス: “pending” または “done”取り得る値:
pending、doneobject
ビデオ生成リクエストの使用情報
integer
このリクエストのコストを USD ticks で表したもの。1 USD セントは 100,000,000 ticks に等しく、1 米ドルは 10,000,000,000 ticks に等しくなります。
object
xAI によって生成されたビデオ
integer
生成されたビデオの再生時間(秒)
boolean
モデルによって生成されたビデオがモデレーションルールに従っているかどうか
string
生成されたビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再現されるため、その後のポーリングでは残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに xAI 自身の短命な URL を保持します。NULLABLE:
url が空の成功は、生成が完了したことを意味しません。いずれの場合もリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。例
入力
出力
出荷前の確認
SDK はIdempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。
リクエストが失敗すると、Router は理由を説明する X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、413 はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。リクエスト本文のサイズ を参照してください。
このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ comfy-sdk / @comfyorg/sdk パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: Comfy(api_key=...) / new Comfy({ apiKey })、および client.workflows、client.assets、client.jobs。Comfy SDKs を参照してください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。