SpaceXAI: Grok Imagine Video 1.5 Lite

Grok Imagine Video 1.5 Liteは、文章で描いたシーンや開始画像から、音声付きの短いクリップを生成します。1〜15秒の出力、横向き・縦向きの構図、リップシンクした発話に対応します。480pまたは720pを直接選択でき、720pからアップスケールした1080p出力も用意されています。高度な参照素材やフレームの制御は、フル版1.5の機能です。

Ailoot Ultra · 動画 POST /v1/videos x-ai/grok-imagine-video-1.5-lite

モデルについて

この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。

Grok Imagine Video 1.5 Liteは、Grok Imagine動画ファミリーのシンプルな生成エディションです。メーカーは、基本的なテキストから動画、画像から動画の制作に推奨しています。文章で描いたシーンを短いクリップにしたり、用意した静止画をアニメーションショットの開始フレームにしたりできます。出力には生成音声が含まれ、このエディションでもリップシンクした発話に対応します。短い商品の動き、雰囲気を伝える導入ショット、キャラクターが簡単なせりふを話す場面などの制作に役立ちます。

テキストから動画を作る場合は、何が見えるか、ショット内で何が起きるか、カメラがそれをどう捉えるかを記述します。照明、テンポ、関連する音も含めます。メーカーの説明では、Liteはまずプロンプトから画像を描画し、それを動画化します。この中間の静止画は、独立した素材としては返されません。実際の準備では、短いクリップに明確な出来事を一つ設定し、それが展開する余裕を持たせます。広い屋外の風景、商品の細部のクローズアップ、人物が話すポートレートでは、それぞれ異なる構図と動きの指示が必要です。

例えば独自の制作指示として、静かな朝食のテーブルに置かれた陶器のカップへゆっくり近づき、湯気が立ち上る場面を、柔らかな朝の光と控えめな室内の環境音で描くよう求められます。確認すべき点は、カップの形を認識できる状態が保たれているか、湯気が自然に動いているか、カメラが意図した方向へ進んでいるかです。このショットを評価するときは、動きを単純に保ちます。キャラクターが話す場合は、話すせりふと簡潔な話し方の説明を含め、結果の言葉と口の動きを確認します。

画像から動画を作る場合、画像が最初のフレームを決め、プロンプトがその後の出来事を記述します。意図した被写体、構図、見た目の細部がすでに整った開始静止画を選びます。小さく首を回す、カメラが穏やかに動く、風で布が揺れるなど、既存の構図に合う動きを指示します。出力は画像のアスペクト比に従い、このモードでは別途指定するアスペクト比設定は無視されます。最終クリップを縦向きにする必要がある場合は、事前に縦向きへトリミングします。

文書化されている出力時間は1〜15秒で、既定値は8秒です。テキストから動画では、1:1、16:9、9:16、4:3、3:4、3:2、2:3、21:9、5:2など、正方形、横向き、縦向き、よりワイドな構図を選べます。構図を選ぶ前に、ショットの用途を決めます。SNS向けの縦動画には後から字幕を載せる余白が必要な場合があり、横向きの挿入映像には編集しやすいよう被写体の周囲の空間が必要な場合があります。長い一連の動きを短いショットに詰め込まず、クリップの長さに合う動作を求めます。

Liteでは480pと720pに加え、720pをアップスケールして作る1080pを選べます。細部が重要な素材を計画する際は、この違いが重要です。出力フレームが大きくても、このエディションがシーンをネイティブ1080pで描画することにはなりません。小さな文字、商品の輪郭、顔を、実際の表示サイズで確認します。生成動画には既定で音声が含まれ、メーカーの生成設定では無音の結果も選べます。生成された音声トラックを使う場合は、見える動作と同じくらい丁寧に音の意図を指定します。

文書化されたメーカーのインターフェースでは、生成は非同期です。処理中はリクエスト識別子で進行を追跡し、完了した応答から動画の場所と長さを取得します。ガイドの完了例はMP4クリップを示し、出力先は一時的なものと説明しています。編集を準備する際は、完成した素材とともに、プロンプト、元画像、選択した設定を保存します。ジョブを送信した段階はまだ処理の途中であり、制作に使える結果は、必要な映像と音声を備えた再生可能なクリップです。

エディションはショットに必要な制御に応じて選びます。フル版Grok Imagine Video 1.5には、複数画像の参照、選択した音声の参照、正確な開始・終了フレーム、中間の固定フレームが加わり、テキストや画像からの動画をネイティブ1080pで描画します。Liteはプロンプトまたは一つの開始画像に集中しています。従来版Grok Imagine Videoには、動画の編集と延長のワークフローがあります。こうした違いを踏まえることで、ファミリーの各モデルを同一の生成器として扱わず、手元の入力素材に合うモデルを選べます。

完成したショットでは、被写体の一貫性、自然な動き、構図、要求した音を確認します。対話がある場合は、言葉とキャラクターの口との同期を両方確認します。複数のクリップを一連の映像にする場合は、各指示で関連する被写体の説明や開始ビジュアルを保持し、編集上のつながりを評価します。短いショットを適切に指定すると、次に変えるべき点が元画像、動作、カメラ、せりふのどれなのかを特定しやすくなります。

Ailoot Ultra · 動画 POST /v1/videos x-ai/grok-imagine-video-1.5-lite

x-ai/grok-imagine-video-1.5-lite

SpaceXAI /x-ai/grok-imagine-video-1.5-lite

はじめに

対応する入力: テキスト · 画像
結果: 動画

Ailootで利用可能 · 入力とメソッド

Ailoot Ultra · 動画 POST /v1/videos

入力の種類: text, image
出力の種類: video
出力形式: 元のMP4バイト列（正規化・トランスコードなし）

フィールド	種類	要件	値と制限	デフォルト
フィールド`model`	種類`string`	要件必須	値と制限 x-ai/grok-imagine-video-1.5-lite	デフォルト—
フィールド`prompt`	種類`string`	要件必須	値と制限	デフォルト—
フィールド`duration`	種類`integer`	要件必須	値と制限 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 最小値: 1 最大値: 600	デフォルト—
フィールド`resolution`	種類`string`	要件任意	値と制限 480p, 720p, 1080p	デフォルト—
フィールド`aspect_ratio`	種類`string`	要件任意	値と制限 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3	デフォルト—
フィールド`generate_audio`	種類`boolean`	要件任意	値と制限 false	デフォルト—
フィールド`frame_images`	種類`array`	要件任意	値と制限最小項目数: 1 最大項目数: 1 入力コンテンツ: フレームオブジェクトの配列。各オブジェクトにはtype=image_url、urlを含むimage_url、およびframe_typeを指定します。HTTPS画像URLを使用し、frame_typeをfirst_frameに設定してください。各フレームの役割はそれぞれ最大一回まで指定できます。正確なキー: type, image_url, frame_type 条件: これらのキーは各フレームオブジェクトを記述します。image_urlに含めるのはurlのみです。テキストのみのリクエストではframe_imagesを省略してください。	デフォルト—
フィールド`input_references`	種類`array`	要件任意	値と制限	デフォルト—
フィールド`callback_url`	種類`string`	要件任意	値と制限パターン: ^https://	デフォルト—
フィールド`session_id`	種類`string`	要件任意	値と制限	デフォルト—
フィールド`trace`	種類`object`	要件任意	値と制限	デフォルト—
フィールド`user`	種類`string`	要件任意	値と制限	デフォルト—

入力素材の組み合わせ

テキストから動画へ · テキストのプロンプト。 · 必須: model, prompt, duration

promptをテキスト、durationを整数の秒数で指定してください。サポートされている解像度を選び、必要に応じてアスペクト比を指定します。

model: 種類: string · x-ai/grok-imagine-video-1.5-lite

prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい

画像から動画へ · テキストのプロンプトと先頭フレーム画像。 · 必須: model, prompt, duration, frame_images

frame_imagesは配列です。各フレームオブジェクトにはtype、image_url、frame_typeがあり、image_urlにはurlを含めます。typeをimage_urlに設定してください。first_frameを使用します。各フレームの役割は、それぞれ最大一回まで指定できます。各フレームには公開HTTPS画像URLを指定してください。サポートされている解像度を選び、必要に応じてアスペクト比を指定します。

正確なキー: type, image_url, frame_type

model: 種類: string · x-ai/grok-imagine-video-1.5-lite

prompt: 種類: string · 最大UTF-8バイト数: 10,000 · 空白以外の文字が必須: はい

メソッドのパラメータとライフサイクル

パラメータ	仕様
パラメータ`content_type`	仕様application/json
パラメータ`required`	仕様model, prompt, duration
パラメータ`material_types`	仕様text, image
パラメータ`additional_properties`	仕様false
パラメータ`optional_controls`	仕様resolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

ライフサイクル: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

料金

最終料金の計算方法

表示料金は生成前の費用の見積もりです。最終請求額は、元の生成処理に記録された費用から計算されます。実測された出力時間や予測数量が、そのまま最終的な課金数量になるわけではありません。

料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。

高速モード: 未指定高速モードが選択されている場合
Flex モード: 未指定 flex モードが選択されている場合
最大推論量: 未指定推論量が最大で、調整に既定値（default）を使用する場合

比較用の推定料金

設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

設定	料金表	予測数量	課金単位	課金条件	料金
設定基本トークン料金	料金表基本料金	予測数量—	課金単位—	課金条件—	料金入力 · 入力トークン · 比較専用の見積もり — / 1K トークン出力 · 出力トークン · 比較専用の見積もり — / 1K トークン入力 · キャッシュ読み取り · 比較専用の見積もり — / 1K トークン入力 · キャッシュ書き込み · 比較専用の見積もり — / 1K トークン入力 · キャッシュ書き込み、1時間 · 比較専用の見積もり — / 1K トークン
設定入力画像	料金表—	予測数量—	課金単位画像あたり	課金条件この価格キーには追加条件が定義されていません。	料金入力 · 入力画像 · 比較専用の見積もり $0.02 画像あたり
設定動画料金	料金表—	予測数量—	課金単位動画1秒あたり	課金条件resolution: 1080p	料金出力 · 動画料金 · 比較専用の見積もり $0.28 動画1秒あたり
設定動画料金	料金表—	予測数量—	課金単位動画1秒あたり	課金条件resolution: 480p	料金出力 · 動画料金 · 比較専用の見積もり $0.04 動画1秒あたり
設定動画料金	料金表—	予測数量—	課金単位動画1秒あたり	課金条件resolution: 720p	料金出力 · 動画料金 · 比較専用の見積もり $0.06 動画1秒あたり
設定生成費用の見積もり	料金表—	予測数量生成1回分の概算	課金単位—	課金条件—	料金出力 · 推定生成コスト · 比較専用の見積もり $0.04 生成前の見積もりこの見積もりは追加料金ではなく、完了した生成処理に対する固定料金でもありません。

Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →

参考料金の詳細

モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。

動画設定の料金参照情報

設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

設定	課金条件	料金
設定入力画像	課金条件この価格キーには追加条件が定義されていません。	料金入力 · 入力画像 $0.02 画像あたり表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。
設定動画料金	課金条件resolution: 480p	料金出力 · 動画料金 $0.04 動画1秒あたり表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。
設定動画料金	課金条件resolution: 720p	料金出力 · 動画料金 $0.06 動画1秒あたり表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。
設定動画料金	課金条件resolution: 1080p	料金出力 · 動画料金 $0.28 動画1秒あたり表示されている設定の公開料金の参照値です。最終請求額には、実際に課金された設定が適用されます。

リクエスト例

Ailoot Ultra · 動画

curl · 動画を作成する

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"x-ai/grok-imagine-video-1.5-lite","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

結果を受け取って保存

Ailoot Ultra · 動画

所有コンテンツの署名付きURL

GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content

ジョブのステータスを確認

GET · 元の処理のステータス取得

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

その他のコンテンツ取得

完了した自分の出力をすべて保存

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS

完了した結果をすべて保存

完了した動画や返されたファイルをすべて保存し、実際に返されたすべてのアセットURLから取得してください。

実際に得られた所有出力と、返された実測メタデータをすべて保持してください。

元のレスポンスを確認する場合

503 result_pending_check + 元のid + X-Should-Retry:false；元のリクエストを決して再実行しないでください

レスポンスのフィールド

フィールド	種類	意味
フィールド`index`	種類integer	意味出力リスト内での、この動画のゼロ始まりの位置。
フィールド`content_url`	種類string	意味この完了済み動画の署名付きHTTPSダウンロードURL。
フィールド`sha256`	種類string \| null	意味元の動画バイト列のSHA-256ダイジェスト。取得できない場合はnullです。
フィールド`size_bytes`	種類integer \| null	意味元の動画ファイルのサイズ（バイト）。取得できない場合はnullです。
フィールド`duration_ms`	種類integer \| null	意味実測された動画の長さ（ミリ秒）。取得できない場合はnullです。
フィールド`width`	種類integer \| null	意味動画の幅（ピクセル）。取得できない場合はnullです。
フィールド`height`	種類integer \| null	意味動画の高さ（ピクセル）。取得できない場合はnullです。
フィールド`video_codec`	種類string \| null	意味動画コーデックの識別子。記録されていない場合はnullです。
フィールド`has_audio`	種類boolean \| null	意味動画に音声トラックが含まれるかどうか。未測定の場合はnullです。
フィールド`audio_codec`	種類string \| null	意味音声コーデックの識別子。識別子が記録されていない場合はnullです。

エラーと次の手順

レスポンス	条件	次の手順
レスポンス404 · `not_found_error`	条件動画へのアクセスが利用できないか、この動画IDが見つかりません。	次の手順動画へのアクセス権を確認してください。既存の動画には、元の公開IDと同じAPIキーを使用してください。
レスポンス401 · `authentication_error`	条件APIキーが認証済みアカウントと一致しません。	次の手順送信する前に、APIキーとアカウントのアクセス権を確認してください。
レスポンス400 · `invalid_request_error`	条件リクエストを読み取れないか、ダウンロードのインデックスが無効です。	次の手順リクエスト本文を修正してください。ダウンロードする場合は、元のタスクから返された出力インデックスを選択してください。
レスポンス422 · `price_unavailable`	条件選択された動画設定の料金を算出できません。	次の手順サポートされている動画設定を選び、必須オプションをすべて指定してから、修正したリクエストを送信してください。
レスポンス422 · `invalid_request_error`	条件動画入力、または元の継続タスクが無効です。	次の手順有効なHTTPS入力を使用してください。継続する場合は、完了した元の動画の公開IDと、同じAPIキーを使用してください。
レスポンス402 · `billing_error`	条件利用可能な残高または上限の制約により、料金を仮押さえできません。	次の手順新しいリクエストを送る前に、利用可能な残高と上限を確認してください。
レスポンス503 · `server_error`	条件動画の検証、保存領域、またはサービスへのアクセスを一時的に利用できません。	次の手順サービスが利用可能になるまでお待ちください。すでに動画IDがある場合は、別の生成を作成せず、その元のタスクを確認してください。
レスポンス503 · `result_pending_check`	条件元の動画の結果と請求額を確認する必要があります。	次の手順返された動画IDを保持し、そのタスクを確認してください。確認中に、代わりの生成リクエストを送信しないでください。
レスポンス503 · `owned_result_unavailable`	条件既存の動画のダウンロードを一時的に利用できません。	次の手順後で同じ動画タスクを確認し、その既存の出力をダウンロードしてください。新しい生成を行うと、別の操作が作成されます。
レスポンス409 · `video_not_ready`	条件動画コンテンツは公開されていません。	次の手順元のタスクのステータスを確認してください。completedと報告されたらダウンロードします。failedと報告された場合は、その料金確認の通知に従ってください。

エイリアス

モデルのエイリアス

Ailoot Ultra x-ai/grok-imagine-video-1.5-lite

メソッドパスのエイリアス

上記に表示されたメソッドパスを使用してください。

SpaceXAI: Grok Imagine Video 1.5 Lite