Skip to main content
POST
  • Image-to-video only. Text-to-video is not supported.
  • Requires exactly one public reference image URL.
  • Supports 10 and 15 second videos.
  • Supports only 16:9 and 9:16 aspect ratios.
  • Async task API: poll video task status with the returned task ID.
Do not pass base64 image data. Upload local files with the Upload Image API, then pass the returned public URL in images.

Authorizations

Authorization
string
required
All API requests require Bearer Token authentication.

Body

model
string
default:"grok-video-1.5-preview"
required
Use grok-video-1.5-preview.
prompt
string
required
Describe the motion, camera movement, and visual direction for the reference image.
images
string[]
required
Pass exactly one public image URL.
  • Minimum: 1
  • Maximum: 1
  • Supported URL schemes: http://, https://
seconds
string
default:"10"
Video duration.Supported values: "10", "15"
aspect_ratio
string
default:"16:9"
Video aspect ratio.Supported values: 16:9, 9:16

Pricing

Response

id
string
Task identifier for polling video status.
object
string
Object type, always generation.task.
model
string
Model name used for the task.
status
string
Task status: queued, in_progress, completed, or failed.

Create a video task

Query task status

Use the returned id with Video Task Status.