xAI 動画を作成する

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the still image with a slow camera move and natural motion.",
    "image": {"url": "https://your-image-host/source.jpg"},
    "duration": 1,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "request_id": "<request_id>"
}

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

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

model: grok-imagine-video-1.5 を使用します
image.url には公開された JPEG、PNG、または WebP の URL を設定します
最初のリクエストでは、duration は 1、resolution は 720p のままにします
アニメーションの方向性が明確になるよう、prompt は具体的に記述します
base64 を送信する場合は、ドキュメントと OpenAPI の例の形式を data:image/png;base64,<BASE64_IMAGE_DATA> のまま使用します

Duration と resolution

Setting	Supported values	Default	Boundary behavior
`duration`	整数 `1`-`15`	`8`	最初のテストでは短いクリップを使用してください。長いクリップはコストが高く、完了までに時間もかかります。
`resolution`	`480p`, `720p`, `1080p`	例では `720p`	高解像度のリクエストはコストが高く、完了までに時間もかかります。
`aspect_ratio`	`1:1`、`16:9`、`9:16` などの比率ラベル	例では `16:9`	このエンドポイントでは `resolution` と `aspect_ratio` を使用します。正確な `WxH` 指定のために別の `size` フィールドを送信しないでください。

Request combination	Intended output `WxH`
`resolution: 480p`, `aspect_ratio: 1:1`	`480x480`
`resolution: 720p`, `aspect_ratio: 16:9`	`1280x720`
`resolution: 720p`, `aspect_ratio: 9:16`	`720x1280`

タスクフロー

ジョブを作成する

プロンプトと元画像を送信し、返された request_id を保存します。

完了までポーリングする

ネストされたプロバイダーの status が done になるまで、Get xAI video results を呼び出します。

出力を保存する

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

承認

Authorization

string

header

必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json

prompt

string

必須

Prompt describing how the source image should animate. CometAPI requires this field for this route.

例:

"Animate the still image with a slow camera move and natural motion."

aspect_ratio

enum<string>

Output aspect ratio. Combine with resolution to choose the target frame; for example 480p with 1:1 targets 480x480, 720p with 16:9 targets 1280x720, and 720p with 9:16 targets 720x1280. This endpoint does not expose an exact size field.

利用可能なオプション:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

duration

integer

デフォルト:8

Output duration in seconds. Use an integer from 1 through 15. If omitted, CometAPI treats the request as an 8-second generation for billing and default handling.

image

object

Source image for image-to-video. Use a public JPEG, PNG, or WebP URL, or a data URI such as data:image/png;base64,<BASE64_IMAGE_DATA>.

Show child attributes

model

string

デフォルト:grok-imagine-video-1.5

xAI video model id. The default example uses Grok Imagine 1.5 for image-to-video.

例:

"grok-imagine-video-1.5"

output

object

Show child attributes

resolution

enum<string>

デフォルト:720p

Output resolution. Use 720p for a small image-to-video test, or 1080p when you need a higher resolution tier.

利用可能なオプション:

480p,

720p,

1080p

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.

Wan 動画コンテンツをダウンロード

xAI 動画編集を作成する

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the still image with a slow camera move and natural motion.",
    "image": {"url": "https://your-image-host/source.jpg"},
    "duration": 1,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "request_id": "<request_id>"
}

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

APIキー

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

Duration と resolution

タスクフロー

承認

ボディ

レスポンス

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

​Duration と resolution

​タスクフロー

承認

ボディ

レスポンス

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

Duration と resolution

タスクフロー