Grokで動画を作成

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

このエンドポイントを使用して、テキスト、ソース画像、または参照入力から Grok 動画ジョブを開始します。request_id がすぐに返されるため、非同期ワークフローの最初のステップとして扱ってください。常に model: grok-imagine-video-1.5 を明示的に送信してください。model と prompt は、ここで説明する 1.5 のリクエスト形式で必須です。

入力モードを選択する

モード	リクエストフィールド	ルール
テキストから動画	`prompt`	次を省略します: `image`、`reference_images`、および `reference_audios`.
画像から動画	`prompt`, `image.url`	`image.url` は、公開画像 URL または画像データ URI を受け入れます。`image` を参照入力と組み合わせないでください。
参照から動画	`prompt` および次の少なくとも 1 つ: `reference_images` または `reference_audios`	参照画像は最大 7 枚、プリセット音声は最大 3 件まで送信できます。参照から動画の出力は最大 `720p`.

データ URI には data:image/png;base64,<BASE64_IMAGE_DATA> を使用します。各 reference_images 項目では同じ url フィールドを使用します。参照オーディオ項目では、voice_id などのプリセット eve を使用します。プロンプトでは、<IMAGE_0> や <AUDIO_0> などのタグで対応する参照を識別できます。

小規模なリクエストから始める

model: grok-imagine-video-1.5 を使用する
最初のリクエストでは、duration を 1 に、resolution を 480p に設定します。
prompt を明示的に指定して、シーンと動きを明確にします
参照画像と音声を組み合わせる前に、入力モードは一度に 1 つずつ追加します

長さと解像度

設定	サポートされる値	デフォルト	境界値での動作
`duration`	整数 `1`-`15`	`8`	最初のテストには短いクリップを使用してください。長いクリップはコストが高く、完了までに時間がかかります。
`resolution`	`480p`, `720p`, `1080p`	`480p`	高解像度のリクエストはコストが高く、完了までに時間がかかります。参照から動画でサポートされる解像度は最大 `720p`.
`aspect_ratio`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	`16:9` テキストから動画の場合	画像から動画では、省略するとソース画像のアスペクト比が維持されます。

生成された動画にはオーディオトラックが含まれます。アプリケーションが特定の出力形式に依存する場合は、duration、resolution、aspect_ratio を明示的に設定してください。

タスクフロー

ジョブを作成

モデル、プロンプト、および任意の入力を送信し、返された request_id を保存します。

完了するまでポーリングする

以下の xAI動画結果を取得を、最上位の status が done、failed、または expired になるまで呼び出します。タスクメタデータの準備中は、初期レスポンスにエコーバックされた request_id のみが含まれる場合があります。

出力を保存

一時的な配信期間後にも必要な場合は、最終的な video.url を自分のストレージにコピーしてください。

承認

Authorization

string

header

必須

Use your CometAPI API key as the bearer value.

ボディ

application/json

model

enum<string>

必須

The Grok video model ID. Send this field explicitly so the request uses Grok Imagine Video 1.5.

利用可能なオプション:

grok-imagine-video-1.5

例:

"grok-imagine-video-1.5"

prompt

string

必須

A description of the scene, motion, and audio. Reference-to-video prompts can identify inputs with tags such as <IMAGE_0> and <AUDIO_0>.

Minimum string length: 1

例:

"A paper boat glides across a quiet pond at sunrise."

duration

integer

デフォルト:8

The output duration in seconds. Use an integer from 1 through 15.

必須範囲: 1 <= x <= 15

aspect_ratio

enum<string>

The output aspect ratio. Text-to-video uses 16:9 when omitted. Image-to-video uses the source image's aspect ratio when omitted.

利用可能なオプション:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

例:

"16:9"

resolution

enum<string>

デフォルト:480p

The output resolution. Reference-to-video requests support 480p and 720p; text-to-video and image-to-video also support 1080p.

利用可能なオプション:

480p,

720p,

1080p

image

object

The source image for image-to-video. Do not combine this field with reference_images or reference_audios.

Show child attributes

reference_images

object[]

Visual references for reference-to-video. Each item accepts a public image URL or image data URI. Do not combine this field with image.

Required array length: 1 - 7 elements

Show child attributes

reference_audios

object[]

Preset voice references for reference-to-video. Do not combine this field with image.

Required array length: 1 - 3 elements

Show child attributes

レスポンス

200 - application/json

Request accepted.

request_id

string

必須

The deferred request ID used to poll GET /grok/v1/videos/{request_id}.

最終更新日 2026年8月21日

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

コンテンツモデレーション

APIキー

入力モードを選択する

小規模なリクエストから始める

長さと解像度

タスクフロー

承認

ボディ

レスポンス

​入力モードを選択する

​小規模なリクエストから始める

​長さと解像度

​タスクフロー

承認

ボディ

レスポンス

入力モードを選択する

小規模なリクエストから始める

長さと解像度

タスクフロー