Grok Video API on MaxAPI
Grok Video is an xAI Grok Imagine video route on MaxAPI. It uses the asynchronous /v1/videos/generations flow and accepts only the reference modes listed for this concrete model.
Common use cases
- Generate a video from a text prompt or storyboard
- Animate one or more reference images into a video
Endpoints
Video generation is asynchronous. POST the request, then poll the task URL until status is succeeded, failed, or canceled.
- POST /v1/videos/generations
- GET /v1/videos/generations/{task_id}
Lineage
Source family: xAI Grok Imagine Video. MaxAPI exposes the supported generation mode through /v1/videos/generations with task-based polling.
Dimensions and sizing
Supports 480p, 720p. Supported aspect ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3. Supported reference modes: text_to_video, image_to_video. Allowed duration tiers are 10, 16, 20 seconds.
Available routes
This model runs on a single route: mix. Call it with an API key that permits the mix route (route_mode defaults to mix; sending a different route_mode is rejected).
- mix — blended route that may switch between configured providers for cost, availability, and fallback coverage; billing follows the published entry for this model.
Pricing
Pricing is per route mode. Failed requests are not charged. 1 credit = 1 USD.
- mix: 480p $0.009701 per second
- mix: 720p $0.009701 per second
- mix: 480p $0.044776 per-video base fee
- mix: 720p $0.044776 per-video base fee
Quick example
curl -X POST "https://api.maxapi.dev/v1/videos/generations" \
-H "Authorization: Bearer $MAXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-video",
"prompt": "a calm ocean wave at sunrise, slow camera pan",
"ratio": "16:9",
"duration": 10,
"mode": "text_to_video",
"resolution": "720p"
}'
FAQ
How do I call Grok Video on MaxAPI?
Send a request to POST /v1/videos/generations with an Authorization: Bearer header, then poll the returned task URL.
How do I switch between route_mode options?
Grok Video runs on a single route: mix. There is nothing to switch — call it with an API key that permits the mix route.
How is billing handled?
Failed requests don't charge credits. Per-image, per-call, and per-generation pricing is billed on completion; token-priced routes settle from upstream usage. 1 credit = 1 USD.
Where does the returned media URL live?
Generated media is normally stored on MaxAPI's CDN for seven days. Pass "asset_delivery": "mirror" on supported generation endpoints to receive URLs on the configured alias domain instead.
Provider source: xAI Grok Imagine Video documentation
Full API reference