メインコンテンツへスキップ
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A candle flickers on a wooden table."
}
'
{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

このエンドポイントを使用すると、テキスト、またはテキストと1枚の元画像から Grok の動画ジョブを開始できます。request_id が即座に返されるため、非同期ワークフローの最初のステップとして扱ってください。

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

  • model: grok-imagine-video を使用します
  • 最初のリクエストでは、duration は 1、resolution は 480p のままにします
  • 画像から動画を生成したい場合にのみ image.url を追加します
  • base64 を送信する場合は、ドキュメントと OpenAPI の例の形式を data:image/png;base64,<BASE64_IMAGE_DATA> のまま使用します

​
タスクの流れ

1

ジョブを作成

プロンプトを送信し、返された request_id を保存します。
2

完了までポーリング

ネストされたプロバイダーの status が done になるまで、動画生成結果を取得 を呼び出します。
3

出力を永続化

プロバイダーの一時的な配信期間後も必要な場合は、最終的な video.url を自分のストレージにコピーします。

承認

​
Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json
​
prompt
string
必須

Prompt for the video job.

例:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

利用可能なオプション:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
デフォルト:1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

​
image
object

Optional source image for image-to-video.

​
model
string
デフォルト:grok-imagine-video

xAI video model id.

例:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

利用可能なオプション:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

レスポンス

200 - application/json

Request accepted.

​
request_id
string
必須

Deferred request id used for polling.