ナビゲーションにスキップ
BeatAPIGrok Imagine Video 1.5Video API

Grok Imagine Video 1.5

Generate 1–15 second videos from text, one first frame, or up to seven image references at 480p, 720p, or 1080p. 1080p accepts at most one image.

Supported modes

ModeRequired inputRules
Text to videomodel, promptOmit images and reference_images.
First framemodel, prompt, imagesProvide one image URL and omit aspect_ratio.
Reference imagesmodel, prompt, reference_imagesProvide 1–7 URLs; 1080p accepts at most one image.

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

認証

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

ヘッダー

Idempotency-Keystringオプション<=255 characters

リクエスト

This endpoint expects an object.
model"grok-imagine-video-1.5"必須

Must be grok-imagine-video-1.5.

promptstring必須1-4096 characters
Video generation instructions.
imageslist of stringsオプション

One first-frame image as a public HTTPS URL.

reference_imageslist of stringsオプション
One to seven public HTTPS reference images.
durationintegerオプション1-15デフォルト値 8
Requested output duration in seconds.
aspect_ratioenumオプションデフォルト値 16:9

Output video aspect ratio. Omit when one first-frame image is supplied.

resolutionenumオプションデフォルト値 480p
Output resolution tier. 1080p accepts at most one image.
許可された値:

レスポンス

Video generation task accepted

エラー

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error