メインコンテンツへスキップ

概要

Grok Imagine Video は、xAI の動画モデル向けの公式チャネルです。リクエストは APIYI によって公式の xAI API へリレーされ、価格は xAI の定価と同一で、課金は生成された秒数と解像度に基づいて行われます。API は OpenAI Videos 互換の非同期タスクエンドポイント(/v1/videos)であり、テキストからの動画生成および画像からの動画生成をサポートし、すべての動画に音声トラックが付属します。 以下の3つのモデルが利用可能です:
  • grok-imagine-video: 基本モデル、480p / 720p
  • grok-imagine-video-1.5: より新しいモデル、480p / 720p / 1080p
  • grok-imagine-video-1.5-lite: 軽量な 1.5、480p / 720p における最安価格
🔒 このチャネルには申請により付与される GrokOfficial グループが必要ですGrok Imagine Video は Default グループには含まれていません。このファミリーのコンテンツセーフティポリシーはプラットフォーム上の他のモデルと大きく異なるため、コンプライアンスリスクを抑制する目的でアクセス権を限定的に付与しています:
  • 累計ご利用額が $1,000 以上のお客様:サポートにお問い合わせの上、ユースケースをお知らせください。確認後に有効化いたします
  • それ以外のお客様:WeCom サポートから申請し、ユースケースおよびコンテンツモデレーション対策をお知らせください。承認され次第、有効化いたします
GrokOfficial グループのない token は 503 を返します。これは権限の問題であり、サービス障害ではありません。詳細は下記の グループ設定 を参照してください。
⚠️ size を指定しない場合、デフォルトは 480p および 8秒となります解像度または再生時間を指定せずに送信した場合、動画は 480p、8秒 として生成および課金されます。720p / 1080p やより短いクリップが必要な場合は、size("1280x720" など)および seconds を明示的に渡してください。

動画生成 API

テキストからの動画生成 / 画像からの動画生成タスクを送信できます。インタラクティブな Playground も備えています。

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. モデルを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)を参照してください。
  • さらに段階的なチャージボーナスが適用されます。大口の法人のお客様は、専用の価格設定についてセールス担当までお問い合わせいただけます。

グループの設定

Grok Imagine VideoはDefaultグループには含まれていません。 本機能はGrok Imagine公式画像と共有される**GrokOfficialグループ(xAIと同価格、上記の表を参照)**に属しており、利用申請が必要です。

利用資格

申請方法

1

WeComサポートにお問い合わせ

WeComサポートまたはメール([email protected])にて申請してください。**GrokOfficial(Grok Imagine公式)**の申請である旨をお伝えください。
2

ユースケースとモデレーション体制の提示

動画の用途、エンドユーザーの属性、および貴社側で実施するコンテンツ審査・人的チェック体制の3点を記載してください。具体的であるほど、審査がスムーズに進みます。
3

承認後にTokenグループを切り替え

承認されると、お客様のアカウントでGrokOfficialが有効化されます。コンソールのTokenページに移動し、このチャネルで使用するTokenをGrokOfficialに切り替え、課金モードをPay-as-you-go PriorityまたはPay-as-you-goに設定してください。
アクセス権が付与される前の動作: GrokOfficialグループのないTokenは、**503(現在のグループに利用可能なチャネルがありません)**を返します。グループが有効化されるまでは、再試行しても解決しません。Pay-per-request課金モードは使用しないでください: このチャネルは秒単位で課金されるため、リクエスト単位課金のTokenはルーティングできず、同様に503が返されます。
コンプライアンスに関する注意事項: アクセス権が付与された後、生成されたコンテンツに対する責任は呼び出し元に帰属します。現地の法規制を遵守し、違法なコンテンツ、他者の肖像権や知的財産権を侵害するコンテンツ、または未成年者に不適切なコンテンツを生成しないでください。一般消費者向けに配信する場合は、独自のモデレーション層を追加してください。背景情報:海外モデル呼び出しに関するコンプライアンス注意事項。不正利用が確認された場合、グループへのアクセス権を取り消します。

技術仕様

エンドポイント

プライマリドメインはhttps://api.apiyi.com、バックアップドメインはhttps://b.apiyi.comです。完全なコードサンプル:動画生成API。

エンドツーエンドフロー(Python)

主要パラメータ

size (解像度とアスペクト比)

sizeはWIDTHxHEIGHTピクセルを使用します。ゲートウェイは短い方の辺から解像度ティアを選択し、アスペクト比をサポートされている最も近い値に自動調整します: また、"480p" / "720p" / "1080p"を直接渡すことや、sizeを省略してxAIのネイティブフィールドresolution(480p / 720p / 1080p)とaspect_ratio(9:16など)を送信することも可能です。両方が指定されている場合は、resolution / aspect_ratioが優先されます。どちらも指定されていない場合、動画は480pで生成されます。
grok-imagine-videoは480p / 720pのみをサポートしています。1080pクラスのsizeを指定すると400: grok-imagine-video resolution must be one of 480p, 720pが返されます。

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

1〜2秒かつ480pでプロンプトをテストする

課金は秒単位で行われるため、720p / 1080pで最終的な長さをレンダリングする前に、短時間の低解像度クリップで仕上がりを確認してください。grok-imagine-video-1.5-liteは480p / 720pのレートが最も低く、バッチ探索に適しています。
2

常にsizeとsecondsを渡す

これらを省略すると480pの8秒に設定されます。これは、「なぜこんなに高いのか」「なぜこんなに不鮮明なのか」という問題の最も一般的な原因です。
3

全体のタイムアウトを設定し、5〜10秒ごとにポーリングする

ジョブは通常20秒から2分以内に完了します。ポーリング頻度を上げてもメリットはありません。合計時間を最大10分に制限し、タイムアウトした場合はトラブルシューティング用にタスクIDを記録してください。
4

モデレーションによるブロックを処理する

ステータスレスポンス内のerror.codeを確認してください。moderation_blockedはジョブがブロックされ、動画が存在せず、課金が行われたことを意味します。そのまま再試行するのではなく、表現を変更してから再送信してください。
5

動画をすぐに保存する

ジョブがcompletedになったら、速やかに/contentからダウンロードしてください。ダウンロードリンクを長期間保持したり、エンドユーザーに直接渡したりしないでください。

エラーコードとリトライ

FAQ

ほぼ確実に権限の問題です。TokenのグループにGrokOfficialがないか、Tokenの課金モードがリクエストごとの従量課金になっています。前者の場合はグループ設定から申請してください。後者の場合は、課金モードをPay-as-you-go PriorityまたはPay-as-you-goに切り替えてください。
それらはデフォルト値です。sizeとsecondsを指定しない場合、ジョブは480p・8秒として生成され、課金されます。size("1280x720"など)とsecondsを明示的に指定してください。
ステータスレスポンスにerror.code: "moderation_blocked"が含まれているか確認してください。含まれている場合、xAIのコンテンツモデレーションによって動画がブロックされています。タスクはcompletedとレポートされますが、動画は存在せず、課金も発生します(xAIはブロックされた動画に対しても課金します)。promptまたは入力画像を調整して再送信してください。
いいえ、安くなりません。動画にはデフォルトで音声トラックが含まれており、xAIの価格設定では音声をオフにしても料金は下がりません。
Image-to-Videoは入力画像のフレームに準拠します。特定のアスペクト比にしたい場合は、送信前に入力画像をその比率にトリミングしてください。
現在このチャンネルでは、Text-to-Videoおよび1枚の入力画像によるImage-to-Videoに対応しています。動画の編集や延長などの機能はまだ提供されていません。提供が開始され次第、このページを更新します。
  • 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

関連ドキュメント