grok-imagine-video

Grok Imagine Videoは、長さと画面の形を選び、テキストの説明から短い動画を作成します。xAIのモデル自体は、画像のアニメーション化や、指定した変更を加える動画編集にも対応しています。

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

モデルについて

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

説明から動画へ

Grok Imagine Videoは、テキストから動画を作成します。xAIのモデル自体には、元画像や動画を使うモードもあります。公表されたAilootの生成メソッドでは、入力はテキストの説明、結果は動画です。

生成は非同期で実行します。先にタスクを作成し、その後、識別子で状態と完成した結果を取得します。xAIによると、動画の作成には数分かかる場合があります。時間は、シーンの複雑さ、長さ、解像度、選択したモードによって変わります。

長さと画面

動画の作成には、1〜15秒を指定できます。画面の比率には、1:1、16:9、9:16、4:3、3:4、3:2、2:3があり、標準は16:9です。このバージョンには480pと720pが用意され、1080pはバージョン1.5に関するものです。

元画像のアニメーション化

xAIの画像モードでは、画像が最初のフレームになり、テキストの指示が動きを指定します。既定では、動画の形は元画像の比率に従います。アスペクト比を明示すると、その形を変更し、画像が引き伸ばされる場合があります。

指定した変更を加える編集

完成した動画を使う場合、モデルは、シーンのほかの内容を保ちながら、説明された変更を適用します。元動画の演出を保ち、必要な要素を変更するのに役立つモードです。長さと比率は元動画から継承し、新しい長さや画面の形は指定しません。

編集用の元動画は8.7秒まで、結果の解像度は720p以下に制限されます。1080pの素材は720pに縮小します。テキストからの生成設定が、自動的に編集に適用されるわけではありません。

完成した動画を続ける

xAIの別のモードでは、このバージョンは元動画の最後のフレームから続きを作成します。元のMP4は2〜15秒、追加部分は2〜10秒、既定では6秒です。結果は、元動画と続きを組み合わせます。比率と解像度は元動画から継承し、上限は720pです。このモードで別に変更することはできません。メーカーのこの機能は、公表されたAilootのテキストからの生成とは異なります。

参照資料とバージョンの範囲

xAIは、シーン内の人物、服、物体の外観を導くため、視覚的な参照資料の利用を用意しています。参照資料は視覚的な特徴を示すもので、最初のフレームの正確な画像ではありません。従来のGrok Imagine Videoでは、最初のフレームと参照資料を組み合わせられません。

このバージョンは、最後のフレームの厳密な固定と、途中のキーフレームを受け付けません。これらの機能はGrok Imagine Video 1.5に属します。生成、元画像のアニメーション化、完成動画の変更は異なるモードです。ここで公表されたAilootのメソッドは、テキストからの生成を説明しています。

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

grok-imagine-video

xAI /grok-imagine-video

はじめに

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

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

Ailoot · 動画 POST /v1/videos/generations

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

フィールド	種類	要件	値と制限	デフォルト
フィールド`model`	種類`string`	要件必須	値と制限 grok-imagine-video	デフォルト—
フィールド`prompt`	種類`string`	要件任意	値と制限最小の長さ: 1	デフォルト—
フィールド`duration`	種類`integer`	要件任意	値と制限最小値: 1 最大値: 15 条件: durationとsecondsを両方指定しないでください単位: 秒	デフォルト1
フィールド`seconds`	種類`integer\|integer_string`	要件任意	値と制限最小値: 1 最大値: 15 代替項目: duration	デフォルト—
フィールド`resolution`	種類`string`	要件任意	値と制限 480p, 720p	デフォルト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.002 入力画像あたり
入力: $0.01 入力動画1秒あたり
出力: $0.05 480p・1秒あたり
出力: $0.07 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", "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

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

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

grok-imagine-video