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 | Mode | Required input | Rules | | --- | --- | --- | | Text to video | `model`, `prompt` | Omit `images` and `reference_images`. | | First frame | `model`, `prompt`, `images` | Provide one image URL and omit `aspect_ratio`. | | Reference images | `model`, `prompt`, `reference_images` | Provide 1–7 URLs; 1080p accepts at most one image. | **Async flow:** Create the task, save `data.id`, then [poll the Task](/quick-guide#get-task-status) 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](/quick-guide#errors-and-retry-policy). **Using a local file?** [upload a local input](/quick-guide#upload-an-input-file) first and pass the returned `data.url`.

Authentication

AuthorizationBearer

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

Headers

Idempotency-KeystringOptional<=255 characters

Request

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

Must be grok-imagine-video-1.5.

promptstringRequired1-4096 characters
Video generation instructions.
imageslist of stringsOptional

One first-frame image as a public HTTPS URL.

reference_imageslist of stringsOptional
One to seven public HTTPS reference images.
durationintegerOptional1-15Defaults to 8
Requested output duration in seconds.
aspect_ratioenumOptionalDefaults to 16:9

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

resolutionenumOptionalDefaults to 480p
Output resolution tier. 1080p accepts at most one image.

Response

Video generation task accepted

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
409
Conflict Error
429
Too Many Requests Error