GET

/v1/schemas/grok/video/v1%2Fvideos%2Fgenerations

kind inputactivity videohash ae7ab7ac…extracted Oct 23, 2026version currentsource upstream spec ↗

Request body

12 properties · 0 required · 9 $defs
propertytypedescriptionconstraints
aspect_ratioenumAspect ratio of the generated video. Ignored for image-to-video (first-frame `image` input): the aspect ratio is always derived from the input image.1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 3:2 · +3 more · nullable
durationanyVideo duration in seconds. Range: [1, 15]. Default: 8. Also accepts `seconds` for OpenAI API compatibility. Accepts both number (8) and string ("8") values.1 ≤ n ≤ 15 · format: int32 · default: 8
imageImageUrlOptional input image for image-to-video generation. If provided, generates video with this image as the first frame. Also accepts `input_reference` for compatibility (same semantics — first frame).nullable
keyframesVideoKeyframe[]Optional mid-video keyframe anchors, strictly between the endpoint pins (`image` as the first frame, `last_frame` as the last). Each entry pins an image to appear literally at its timestamp. Only supported by select video models; at most 4 entries.items ≤ 4
modelanyModel to be used.
outputVideoOutputOptional output destination for generated video.nullable
promptstringPrompt for video generation. Required for text-to-video (T2V) and reference-to-video (R2V). Optional for image-to-video (I2V) — when omitted, the model generates a video from the image alone.
reference_audiosAudioUrl[]Optional reference audio clips (voice identity) for reference-to-video generation. Each entry supplies a clip via `url` or selects a voice via `voice_id`; caller-supplied clips must be at most 15 seconds long. Only supported by select video models; at most 3 e…items ≤ 3
reference_imagesImageUrl[]Optional reference images for reference-to-video (R2V) generation. When provided generates video using these images as style/content references.
resolutionenumResolution of the generated video.480p | 720p | 1080p · nullable
storage_optionsStorageOptionsOptional output storage configuration. When present, the generated video is stored in the Files API and a `file_output` reference is returned in the response alongside the ephemeral URL.nullable
useranyA unique identifier representing your end-user.

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"grok","endpointId":"v1/videos/generations","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}