動画を作成

Platform Video Generations API を使用して Grok 動画タスクを作成します。

テキストからの動画生成、画像からの動画生成、Video-to-Video Remix に対応します。

POST/v1/video/generations

Grok 動画生成タスクを作成します。テキストからの動画生成、画像からの動画生成、Video-to-Video Remix に対応します。

モデル ID の例は grok-imagine-video です。例では MODEL_ID を使用しています。実際に利用できるモデルは、現在の API Key で返されるモデル一覧に従います。

認証

bearerAuth

認証Bearer <token>

Authorization Header に Bearer your-api-key を指定します。

指定位置: header

リクエストボディ

application/json

Grok 動画作成リクエストです。

TypeScript 型定義

TypeScript で request body 型を使用します。

model*string

Grok 動画モデル ID です。例：grok-imagine-video。実際に利用できるモデルは、現在の API Key で返されるモデル一覧に従います。

長さ1 <= length

prompt*string

生成またはスタイル変更する動画の内容を記述します。

長さ1 <= length

duration?integer

動画の長さ（秒）です。テキストからの動画生成と画像からの動画生成でのみ有効です。範囲は 1～15、デフォルトは 5 です。Remix モードでは使用できず、出力時間は入力動画と同じで、上限は 8.7 秒です。

範囲1 <= value <= 15

デフォルト値5

images?array<string>

画像から動画を生成する際の入力画像一覧です。image とどちらか一方を指定してください。

image?string

画像から動画を生成する際の単一画像です。公開 URL または Base64 Data URI を指定できます。images とどちらか一方を指定してください。

metadata?

上流サービスへ渡す拡張パラメーターです。seed、negative_prompt、fps など、Grok が対応する高度なパラメーターを透過的に渡せます。

Platform はリクエストパラメーターに基づいてクォータ消費量を動的に計算します。照合と再現に備えて、業務側でも metadata をリクエストとともに保存してください。

レスポンスボディ

`application/json`

curl -X POST "https://example.com/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "雲の上に浮かぶサイバーパンク都市",    "duration": 5,    "image": "https://example.com/init-frame.png",    "metadata": {      "resolution": "720p"    }  }'

{
  "id": "xai-task-12345"
}

認証

リクエストボディ

レスポンスボディ

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`