概要
Grok Imagine Video は、xAI の動画モデル向けの公式チャネルです。リクエストは APIYI によって公式の xAI API へリレーされ、価格は xAI の定価と同一で、課金は生成された秒数と解像度に基づいて行われます。API は OpenAI Videos 互換の非同期タスクエンドポイント(/v1/videos)であり、テキストからの動画生成および画像からの動画生成をサポートし、すべての動画に音声トラックが付属します。
以下の3つのモデルが利用可能です:
grok-imagine-video: 基本モデル、480p / 720pgrok-imagine-video-1.5: より新しいモデル、480p / 720p / 1080pgrok-imagine-video-1.5-lite: 軽量な 1.5、480p / 720p における最安価格
動画生成 API
Grok Imagine 公式画像
GrokOfficial グループ — ティア別で xAI と同一価格の画像生成。AI エージェントに統合を任せる
このプロンプトをコピーして Codex / Claude Code / Cursor に貼り付けます
まずこのページのプレーンテキスト版を取得し(任意のドキュメント URL に .md を追加)、その上であなたの技術スタック向けのコードを記述します。非同期の3ステップフロー、480p / 8秒のデフォルト設定、課金対象となるモデレーションによるブロック、生成後すぐに動画を保存する処理などが、すでに要件として組み込まれています。
このプロジェクトに Grok Imagine の動画生成(テキストから動画 + 画像から動画)を統合 / トラブルシューティングしてください。
コードを書く前にドキュメントをお読みください:このページのプレーンテキスト版を取得するには https://docs.apiyi.com/en/api-capabilities/grok-imagine-video/overview.md をフェッチします;…
- モデルを1つ選択:
grok-imagine-video、grok-imagine-video-1.5、またはgrok-imagine-video-1.5-lite…
合計8つの要件 — 完全版をコピーするには下のボタンを使用してください
モデルと価格
料金はxAIの定価に準拠しており、生成された動画の秒数単位で課金されます。料金はモデルと解像度によって異なります:- コスト = 秒数 × 1秒あたりの料金 + 入力画像数 × 1枚あたりの料金。例:
grok-imagine-videoでの1秒間・480pの画像から動画生成ジョブ = 1 × $0.05 + 1 × $0.002 = $0.052(テスト時の請求額と一致します)。 - デフォルト設定でも課金されます:
size/secondsを指定しない場合、ジョブは480p・8秒で実行され、grok-imagine-videoでは$0.40となります。 - 音声は別途課金されません:動画にはデフォルトで音声トラックが含まれており、無効にしても料金は下がりません。
- モデレーションによるブロックも課金対象となります:xAIはモデレーションによってブロックされた動画に対しても課金を行い、当サービスも同様の基準で課金します。よくある質問(FAQ)を参照してください。
- さらに段階的なチャージボーナスが適用されます。大口の法人のお客様は、専用の価格設定についてセールス担当までお問い合わせいただけます。
グループの設定
利用資格
申請方法
WeComサポートにお問い合わせ
GrokOfficial(Grok Imagine公式)**の申請である旨をお伝えください。ユースケースとモデレーション体制の提示
承認後にTokenグループを切り替え
GrokOfficialが有効化されます。コンソールのTokenページに移動し、このチャネルで使用するTokenをGrokOfficialに切り替え、課金モードをPay-as-you-go PriorityまたはPay-as-you-goに設定してください。GrokOfficialグループのないTokenは、**503(現在のグループに利用可能なチャネルがありません)**を返します。グループが有効化されるまでは、再試行しても解決しません。Pay-per-request課金モードは使用しないでください: このチャネルは秒単位で課金されるため、リクエスト単位課金のTokenはルーティングできず、同様に503が返されます。技術仕様
エンドポイント
エンドツーエンドフロー(Python)
主要パラメータ
size (解像度とアスペクト比)
sizeはWIDTHxHEIGHTピクセルを使用します。ゲートウェイは短い方の辺から解像度ティアを選択し、アスペクト比をサポートされている最も近い値に自動調整します:
"480p" / "720p" / "1080p"を直接渡すことや、sizeを省略してxAIのネイティブフィールドresolution(480p / 720p / 1080p)とaspect_ratio(9:16など)を送信することも可能です。両方が指定されている場合は、resolution / aspect_ratioが優先されます。どちらも指定されていない場合、動画は480pで生成されます。
seconds (再生時間)
文字列("5")または数値(5)による1〜15の整数です。デフォルトは8です。範囲外の値を指定すると400: duration must be an integer between 1 and 15が返されます。コストは秒数に比例するため、テスト時は1〜2秒を指定してください。
input_reference (画像から動画生成)
入力画像を1枚渡すことで、タスクを画像から動画生成(image-to-video)に切り替えることができます。以下の3つの形式のいずれも利用可能です:
- 公開画像URL:
"input_reference": "https://example.com/first-frame.jpg" - base64データURI:
"input_reference": "data:image/jpeg;base64,/9j/4AAQ..." - マルチパートファイルアップロード:
-F "[email protected]"
promptを使用します。出力フレームは入力画像に従います。入力画像1枚につき、追加で$0.002(grok-imagine-video)または$0.01(1.5 / 1.5-lite)の費用がかかります。
ベストプラクティス
1〜2秒かつ480pでプロンプトをテストする
grok-imagine-video-1.5-liteは480p / 720pのレートが最も低く、バッチ探索に適しています。常にsizeとsecondsを渡す
全体のタイムアウトを設定し、5〜10秒ごとにポーリングする
モデレーションによるブロックを処理する
error.codeを確認してください。moderation_blockedはジョブがブロックされ、動画が存在せず、課金が行われたことを意味します。そのまま再試行するのではなく、表現を変更してから再送信してください。動画をすぐに保存する
completedになったら、速やかに/contentからダウンロードしてください。ダウンロードリンクを長期間保持したり、エンドユーザーに直接渡したりしないでください。エラーコードとリトライ
FAQ
すべての呼び出しで503が返されます。チャンネルが停止しているのでしょうか?
すべての呼び出しで503が返されます。チャンネルが停止しているのでしょうか?
GrokOfficialがないか、Tokenの課金モードがリクエストごとの従量課金になっています。前者の場合はグループ設定から申請してください。後者の場合は、課金モードをPay-as-you-go PriorityまたはPay-as-you-goに切り替えてください。動画が480pかつ8秒になるのはなぜですか?
動画が480pかつ8秒になるのはなぜですか?
sizeとsecondsを指定しない場合、ジョブは480p・8秒として生成され、課金されます。size("1280x720"など)とsecondsを明示的に指定してください。タスクは完了と表示されているのに、ダウンロードできる動画がありません。
タスクは完了と表示されているのに、ダウンロードできる動画がありません。
error.code: "moderation_blocked"が含まれているか確認してください。含まれている場合、xAIのコンテンツモデレーションによって動画がブロックされています。タスクはcompletedとレポートされますが、動画は存在せず、課金も発生します(xAIはブロックされた動画に対しても課金します)。promptまたは入力画像を調整して再送信してください。音声なしにすれば安くなりますか?
音声なしにすれば安くなりますか?
Image-to-Videoの出力サイズが送信したサイズと一致しないのはなぜですか?
Image-to-Videoの出力サイズが送信したサイズと一致しないのはなぜですか?
動画の編集、延長、または複数の参照画像には対応していますか?
動画の編集、延長、または複数の参照画像には対応していますか?
3つのモデルのうち、どれを選ぶべきですか?
3つのモデルのうち、どれを選ぶべきですか?
- 1080pが必要な場合 →
grok-imagine-video-1.5(最高品質)またはgrok-imagine-video-1.5-lite(より安価) - 予算を抑えて480p / 720pを一括生成したい場合 →
grok-imagine-video-1.5-lite(1秒あたり$0.02 / $0.03) - すでにベースモデルを利用中で、480p / 720pのみが必要な場合 →
grok-imagine-video
関連ドキュメント
- Grok Imagine 動画生成 API - Playground付きの送信エンドポイントリファレンス
- Grok Imagine 公式画像 - 同一グループ、ティアごとにxAIと同じ価格設定
- Grok モデルガイド - xAI テキストモデル
- チャージボーナス