grok_imagine_1_5 と POST https://api.goenhance.ai/api/v1/videos/generations を使用して、1～7 枚の参照画像をアニメーション化します。長さ、解像度、アスペクト比を制御し、ジョブ ID またはコールバックで完了を追跡します。参照画像から動画を生成する Grok Imagine 1.5 API
Grok Imagine 1.5 ビデオルートでの構築
送信前に、必須の参照画像、プロンプト長、長さ、解像度、比率を検証します。
Grok Imagine 1.5 API の機能
正確なモデル識別子
<code>model</code> には <code>grok_imagine_1_5</code> を設定します。アンダースコアは正確に保持してください。
プロンプト必須
最大 4,096 文字のモーションとシーンのプロンプトを送信します。
画像参照 1～7 枚
必須の <code>image_urls</code> 配列には、一般公開されている画像 URL を 1～7 件指定できます。
検証済みメディア入力
各参照画像は JPEG、PNG、WebP のいずれかで、最大 20 MB です。
1～15 秒
長さは 1～15 秒の整数で選択します。ドキュメント上のデフォルトは 8 秒です。
2 つの出力グレード
480p または 720p を選択します。ドキュメント上のデフォルトは 480p で、<code>auto</code> を含む 6 つの比率値をサポートしています。
GoEnhance は解像度ごとに生成時間を課金します。本番導入前に最新の料金を確認してください。
Grok Imagine 1.5 API の料金
480p の料金
480p は生成 1 秒あたり 0.52 トークンで、トークンあたり $0.02 の場合、1 秒あたり $0.0104 に相当します。
720p の料金
720p は生成 1 秒あたり 0.975 トークンで、トークンあたり $0.02 の場合、1 秒あたり $0.0195 に相当します。
各リクエストの計算
要求した長さに、選択した 1 秒あたりのレートを掛けます。たとえば、8 秒の場合、480p では 4.16 トークン、720p では 7.8 トークンになります。
Grok Imagine 1.5 API の統合
1
1. API キーを作成して安全に保管する
GoEnhance API キーを作成し、サーバーから認証ヘッダーで送信します。ブラウザコードでは絶対に公開しないでください。
2
2. 検証済みの参照画像をホストする
送信前に、対応している参照画像 1～7 枚を公開 URL に配置し、形式、サイズ、アクセスを確認します。
3
3. リクエストの構築
model、prompt、image_urls を設定し、明示的な duration、解像度、比率、および任意の HTTPS コールバック URL を追加します。 4
4. ジョブ ID の送信と永続化
/api/v1/videos/generations に POST し、code を確認して、返された img_uuid を冪等に保存します。 5
5. ポーリングまたはコールバック受信
GET /api/v1/jobs/detail をポーリングするか、ステータス変更コールバックを受け取ります。コールバック配信の失敗時は、1 回あたり 3 秒のタイムアウトで最大 3 回再試行される仕様です。 6
6. 終端結果の処理
成功した場合のみ完了したアセットを永続化し、失敗またはトークン不足のレスポンスは、利用可能な動画結果として扱わずにユーザーに表示します。
ソースの一貫性と API 自動化が重要な場面では、参照駆動の動画生成を使用します。
Grok Imagine 1.5 で開発者が構築するもの
商品モーションクリップ
承認済みの商品レンダリングを、ローンチ、カタログ、キャンペーン向けの短い映像にアニメーション化します。
キャラクター演技テスト
一貫したキャラクター参照アートから、動きと表情を探求します。
ストーリーボードのプリビジュアライゼーション
キーフレームを、テンポ、カメラワーク、シーンレビューのためのモーションスタディに変換します。
ローカライズされたキャンペーンバリエーション
地域ごとのクリエイティブブリーフに合わせてプロンプトを調整しながら、承認済みのビジュアル参照を再利用します。
ソーシャル動画制作
チャンネル別の配置向けに、縦型、正方形、横型のモーションアセットを作成します。
自動化されたクリエイティブパイプライン
アセットの取り込み、リクエスト検証、ジョブ追跡、配信を、再現可能なバックエンドワークフローで接続します。
エンドポイント、必須入力、価格、出力制御、完了処理、プラットフォームとの関係。