xai/grok-imagine-video-1.5 の API リファレンスです。xAI から Comfy Router によって提供されます。
クイックスタート
Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを raw HTTP で実行するものです。
モデル ID: xai/grok-imagine-video-1.5
エンドポイント: POST https://api.comfy.org/v2/models/xai/grok-imagine-video-1.5
- Wait for the result
- Queue and collect later
スキーマ
入力
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 エンコードされた data URI)
string
使用するモデル。対応: grok-imagine-video(デフォルト)、grok-imagine-video-1.5-preview、grok-imagine-video-1.5。非推奨の 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 エンコードされた data URL(例: data:image/jpeg;base64,…)をサポートします。
string
出力ビデオの解像度
string
出力ビデオのサイズ
string
エンドユーザーを表す一意の識別子
GET /v2/models/xai/grok-imagine-video-1.5/openapi.json で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じです。
出力
string
リクエストが入力モデレーションによってブロックされた場合、ブロック理由を含みます
string
ビデオの生成に使用されたモデル
string
遅延リクエストのステータス: “pending” または “done”指定可能な値:
pending、doneobject
ビデオ生成リクエストの使用量情報
integer
USD ticks で表したこのリクエストのコスト。1 米国セントは 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 が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。
ヘッダー
認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。
Router API の利用
モデルの検出、バリデーションエラー、リトライ、課金。
制限事項
Router が現在対応していないことと、代替手段。