Create Grok Video

POST/v1/videos
Start an asynchronous video generation task with a Grok video model.

Request Body

application/json
model:optionalstring

Model identifier used for this request.

Examplegrok-imagine-video
prompt:optionalstring

Text instruction describing the requested output.

ExampleA serene lake at sunrise with mist rolling over the water
duration:optionalinteger

Requested video duration in seconds.

Example8
aspect_ratio:optionalstring

Aspect ratio of the generated media.

Allowed1:116:99:164:33:43:22:3
Example16:9
resolution:optionalstring

Resolution of the generated media.

Allowed480p720p1080p
Example720p

Response

200

A successful request returns a JSON response. The complete example is shown in the code panel.