Skip to main content
POST
Grok Video Generation

Grok Video Generation

OpenAI-format entry point. If you need to use the unified video POST /v1/video/create, see Create Video. The Grok video generation API uses multipart/form-data for submission. Please organize the request according to the fields here.
  • The endpoint path is POST /v1/videos.
  • input_reference is the reference image field and supports uploading multiple images repeatedly.
  • grok-video-3-pro will be automatically fixed to 10 seconds, and grok-video-3-max will be automatically fixed to 15 seconds.
  • The base version grok-video-3 has no additional fixed-seconds logic and is processed according to the actual parameters passed.

Currently Available Models

  • grok-video-3
  • grok-video-3-pro
  • grok-video-3-max

Method and Path

Request Example

Response Example

Authentication

Body

string
required
Model name. The currently available Grok series values are grok-video-3, grok-video-3-pro, and grok-video-3-max.
string
required
Prompt.
string
Video aspect ratio. Optional values are 16:9, 9:16, 2:3, 3:2, and 1:1.
integer
Target duration in seconds. For grok-video-3-pro and grok-video-3-max, this will be automatically corrected to a fixed value.
string
Resolution tier. Common values are 720P or 1080P.
file
Reference image file. Can be passed multiple times, corresponding to multiple input_reference uploads.

Response

string
Task ID.
string
Fixed as video.
string
The actual submitted model name.
string
Task status. Common values include queued, processing, completed, failed, and cancelled.
integer
Progress percentage.
integer
Creation timestamp.
string
Output resolution tier.

Use Cases

Text-to-Video

Just pass the fields model, prompt, seconds, and size.

Image-to-Video

On top of text-to-video, add one or more input_reference files.

Fixed-Duration Models

If you pass grok-video-3-pro or grok-video-3-max, expect the server to process them with a fixed duration.