Skip to main content
POST
Grok Imagine Image to Video
Create a video generation task using the grok-imagine/image-to-video model.

Authentication

All API requests require a Bearer token.

Request Body

Top-level fields

string
required
Must be grok-imagine/image-to-video.
object
required
Input parameters for the video generation task.
string[]
External reference image URLs. Supports JPEG, PNG, and WEBP. Each image can be up to 10 MB. Do not use together with task_id.Use @image(n) in the prompt to reference an uploaded image, for example @image1 a sunset over the ocean.Only one image is supported at 1080p. Spicy mode is unavailable when using external images.
string
Optional English-language prompt describing motion, actions, camera work, timing, environment, and motion dynamics. Maximum length: 5000 characters.
string
default:"normal"
Generation mode:
  • fun — more creative and playful interpretation
  • normal — balanced motion quality
  • spicy — more dynamic and intense motion effects; unavailable for external images
string
Generated video duration in seconds. Supported range: 630, in one-second steps.
string
default:"480p"
Supported values: 480p, 720p, 1080p.
string
default:"16:9"
Applies to multi-image generation. In single-image mode, video dimensions follow the source image dimensions.Supported values: 2:3, 3:2, 1:1, 16:9, 9:16.

Request Example

Response

Successful Response

number
Response status code.
string
Response message. Contains the error description when the request fails.Example: success
object
required
The task data object containing task id.
string
required
The unique identifier for this task.Example: task_123456

Query Task Status

After submitting a task, use the unified query endpoint to check the task progress and retrieve the generated results.

Get Task Details

Check task status, monitor generation progress, and retrieve results.

Error Response

Response Codes