grok-imagine-video-1.5-preview

Grok Imagine Video 1.5は、1〜15秒の動画をテキストから作成し、1080pにも対応しています。モデル自体は、画像のアニメーション化、視覚的な参照資料、キーフレームの設定、音声トラックに対応しています。

Ailoot · 動画 POST /v1/videos/generations grok-imagine-video-1.5-preview

モデルについて

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

動画シーンを作成する

Grok Imagine Video 1.5は、テキストの説明と視覚的な素材から動画を生成するxAIのモデルです。現在のAilootのメソッドでは、テキストからの生成が公表されています。モデル自体の追加モードでは、画像をアニメーション化し、参照資料を利用し、シーンの基準フレームを指定できます。

結果は非同期で作成します。タスクを開始した後、識別子で準備状態を確認します。xAIによると、シーンの複雑さ、長さ、解像度によって、処理には数分かかる場合があります。タスクの識別子を取得しても、動画が完成したことを意味しません。

長さ、比率、解像度

作成する動画は、1〜15秒です。1:1、16:9、9:16、4:3、3:4、3:2、2:3を選べ、テキストの場合の標準は16:9です。画像のアニメーション化では、既定でその比率を保ちます。

テキストと開始画像からの生成には、480p、720p、1080pを利用できます。480pが既定で、参照資料のモードは720pまでに制限されます。モデルに1080pがあるという理由だけで、すべてのモードに適用してはいけません。

外観の制御

xAIの参照資料のモードでは、7枚までの画像を受け取ります。最初のフレームを固定せず、人物、物体、服、その他の視覚的な特徴を指定します。繰り返し登場する人物のシーン、商品のデモンストレーション、演出間で求める外観を保つ用途に向けられています。

最初、最後、途中のフレーム

バージョン1.5では、正確な最初のフレーム、正確な最後のフレーム、または両方を固定できます。最後だけを指定した場合、モデルが開始を作り、指定した画像に到達します。両端を指定した場合、その間の動きを作成します。テキストの指示で、動きやカメラの動作を具体化できます。

動画内の絵コンテには、4つまでのキーフレームを固定できます。各時刻は、厳密に開始後かつ終了前である必要があり、1/3秒のグリッドに紐付けます。同じグリッド時刻に丸められる二つのフレームは拒否されます。避けるためには、少なくとも1/3秒の間隔を残します。最初と最後のフレームは、これらの四つの中間フレームとは別に指定します。

基準フレームは、視覚的な参照資料やプリセットの声と組み合わせられます。少なくとも一つのフレームを固定した場合、テキストの説明は任意です。画像の系列自体がシーンを定めます。キーフレームは、動画編集モードと組み合わせられません。xAIのこれらの機能は、公表されたAilootのテキストからの生成で利用できることを意味しません。

音声と声

生成する動画には、既定で音声トラックが含まれます。無音の結果も用意されています。xAIの声の参照資料のモードでは、3つまでのプリセットの声を選び、シーン内の話者に紐付けられます。

自分の音声ファイルを声のサンプルとして渡すことは、このモデルの一般的な機能ではありません。xAIは、要望に応じて別途提供しています。プリセットの声と、アップロードした音声は、異なる種類の入力です。

動作モード

テキストからの生成は新しいシーンを作り、開始画像は冒頭を定め、参照資料は外観を導き、固定したフレームは時間上の視覚的な点を定めます。各モードには固有の制限があり、一つの方法の設定を別の方法に無条件に適用してはいけません。

Ailoot · 動画 POST /v1/videos/generations grok-imagine-video-1.5-preview

grok-imagine-video-1.5-preview

xAI /grok-imagine-video-1.5-preview

はじめに

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

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

Ailoot · 動画 POST /v1/videos/generations

入力の種類: text
出力の種類: video
出力形式: mp4

フィールド	種類	要件	値と制限	デフォルト
フィールド`model`	種類`string`	要件必須	値と制限 grok-imagine-video-1.5-preview	デフォルト—
フィールド`prompt`	種類`string`	要件任意	値と制限最小の長さ: 1	デフォルト—
フィールド`duration`	種類`integer`	要件任意	値と制限最小値: 1 最大値: 15 条件: durationとsecondsを両方指定しないでください単位: 秒	デフォルト1
フィールド`seconds`	種類`integer\|integer_string`	要件任意	値と制限最小値: 1 最大値: 15 代替項目: duration	デフォルト—
フィールド`resolution`	種類`string`	要件任意	値と制限 480p, 720p, 1080p	デフォルト480p
フィールド`aspect_ratio`	種類`string`	要件任意	値と制限 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 条件: 画像が入力され、アスペクト比が省略された場合、プロバイダーは画像のアスペクト比を引き継ぎます。	デフォルト16:9
フィールド`size`	種類`string`	要件任意	値と制限 1280x720, 720x1280, 1920x1080, 1080x1920 条件: resolution/aspect_ratioも指定する場合は、一致させる必要があります	デフォルト—
フィールド`image`	種類`object`	要件任意	値と制限条件: 実際のサポート対象の入力画像。プロンプトの省略が可能です。	デフォルト—

入力素材の組み合わせ

テキストから動画へ · 必須: prompt

画像から動画へ · 必須: image

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

パラメータ	仕様
パラメータ`material_types`	仕様text
パラメータ`required`	仕様null
パラメータ`optional_controls`	仕様null

ライフサイクル: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

メソッドの形式とIDは正確に記載しています。供給元の対応能力とリクエストの受け入れは別です。

料金

Ailootのメソッド料金

Ailoot 動画POST /v1/videos/generations

入力: $0.01 入力画像あたり
出力: $0.25 1080p・1秒あたり
出力: $0.08 480p・1秒あたり
出力: $0.14 720p・1秒あたり

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

リクエスト例

Ailoot · 動画

動画のサンプル

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-imagine-video-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'

結果を受け取って保存

Ailoot · 動画

mp4

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

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

GET · ステータス取得

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"

その他のコンテンツ取得

GET · コンテンツの取得

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4

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

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

ステータスのJSON全体と、実際のrequest_idを保持してください。status=doneの完了レスポンスには、所有コンテンツのURLを持つvideo.urlが含まれます。報告された長さと、返されたすべての結果フィールドを保持してください。

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

既存の元のジョブを読み取ってください。結果不明の送信を決して再実行しないでください。

レスポンスのフィールド

フィールド	種類
フィールド`request_id`	種類string
フィールド`id`	種類string
フィールド`status`	種類string
フィールド`video.url`	種類owned signed content URL
フィールド`video.duration`	種類number
フィールド`video.respect_moderation`	種類boolean

エラーと次の手順

レスポンス	条件	次の手順
レスポンス400 · `invalid_request_error`	条件必須フィールド、素材の表現形式、またはパラメーター値が不正です	次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。
レスポンス409 · `video_not_ready`	条件元の結果のコンテンツはまだ利用できません	次の手順元の返却IDをポーリングし、Retry-Afterに従ってください。
レスポンス`server_error`	条件返されたレスポンスは、操作または結果の確認が必要であることを示しています	次の手順最初に返された操作／タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。

エイリアス

モデルのエイリアス

Ailoot grok-imagine-video-1.5-preview

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

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

grok-imagine-video-1.5-preview