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-Key
请求
This endpoint expects an object.
model
Must be grok-imagine-video-1.5.
prompt
Video generation instructions.
images
One first-frame image as a public HTTPS URL.
reference_images
One to seven public HTTPS reference images.
duration
Requested output duration in seconds.
aspect_ratio
Output video aspect ratio. Omit when one first-frame image is supplied.
resolution
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

