Skip to main content
POST
Model name: Use grok-imagine-1.5-video-ext for this endpoint.

Authorizations

string
required
All APIs require Bearer Token authenticationGet API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Request Parameters

string
default:"grok-imagine-1.5-video-ext"
required
Video generation model nameSupported models:
  • grok-imagine-1.5-video-ext - Grok Video Generation
Example: "grok-imagine-1.5-video-ext"
Use grok-imagine-1.5-video-ext consistently in new requests.
boolean
default:"false"
Whether to run content moderation before submitting the video task.
  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
string
required
Video content description, supports multiple languages
string
default:"16:9"
Video sizeOptions:
  • 16:9 - Landscape (default)
  • 9:16 - Portrait
  • 1:1 - Square
  • 3:2 - Landscape
  • 2:3 - Portrait
integer
default:6
Video duration (seconds)Range: 6-15 (minimum 6 seconds, maximum 15 seconds)⚠️ Note: Must be a plain number (e.g. 6), do not add quotes, otherwise an error will occur
string
default:"480p"
Video qualityOptions:
  • 480p - Standard definition (default)
  • 720p - High definition
string[]
List of reference image URLsLimits:
  • Maximum 7 images
  • Must be publicly accessible URLs
  • Base64 format is not supported
After uploading a reference image, the aspect ratio will automatically match the reference image’s aspect ratio.

Response

integer
Response status code
object[]
Response data array
Query Task ResultVideo generation is an async task. After submission, a task_id will be returned. Use the Get Task Status endpoint to query generation progress and results.

Use Cases

Case 1: Text-to-Video

Case 2: Image-to-Video