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`.

身份验证

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
409
Conflict Error
429
Too Many Requests Error