Grok Imagine Video
xAI video model for 6 to 30-second clips from text or up to seven reference images, with output up to 1080p.
| Property | Value |
|---|---|
modelSlug | grok-imagine-video |
| Kind | Video |
| Maker | xAI |
Copies per request (variations) | 1 to 5 |
| How the cost is counted | per second of output (from duration), at a rate that depends on resolution |
| Over MCP | yes, with the generate tool |
Credit amounts are left out because they change. The lowest price is creditCost on GET /v1/models, and POST /v1/jobs answers with the exact creditCost of a request.
input fields
Send the fields below inside the input object. A field you leave out takes its Default. Unknown field names are dropped without an error, so check the spelling if a setting seems to have no effect.
| Field | Type | Required | Default | Rules |
|---|---|---|---|---|
prompt | string | – | – | Up to 5,000 characters |
reference_images | string[] (image upload ids) | – | – | Reference images. Up to 7 files |
aspect_ratio | string (one of) | – | 2:3 | 1:1, 2:3, 3:2, 16:9, 9:16 |
resolution | string (one of) | – | 480p | 480p, 720p, 1080p |
duration | string (one of) | – | 6 | 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 |
Rules by setting
This model runs a different version depending on what you send. The rules below are checked before any credits move; a request that breaks one is refused with 400 and a message naming the field.
Without a reference file
- Takes no files in
reference_images; a request that fills one is refused. promptat least 1 characters.
With a reference file and resolution = 1080p
reference_images: required; one file at most; at most 10 MB per file.
With a reference file
reference_images: required; up to 7 files; at most 10 MB per file.
Example request
{
"modelSlug": "grok-imagine-video",
"input": {
"prompt": "The camera circles slowly around a steaming cup of coffee on a wooden table"
}
}