Video generation API
Grok Video
xAI Grok Imagine Video — T2V, I2V, reference, video extend, and editing capabilities.
Provider: xAI6 models
Available models
| Model key | Display name | Capability | Atlas Cloud slug |
|---|---|---|---|
grok_imagine_video_t2v | Grok Imagine Video T2V | text-to-video | xai/grok-imagine-video/text-to-video |
grok_imagine_video_i2v | Grok Imagine Video I2V | image-to-video | xai/grok-imagine-video/image-to-video |
grok_imagine_video_ref2vid | Grok Imagine Video Ref2Vid | reference-to-video | xai/grok-imagine-video/reference-to-video |
grok_imagine_video_extend | Grok Imagine Video Extend | video-extend | xai/grok-imagine-video/extend-video |
grok_imagine_video_edit | Grok Imagine Video Edit | video-edit | xai/grok-imagine-video/edit-video |
grok_imagine_video_1_5_i2v | Grok Imagine Video 1.5 I2V | image-to-video | xai/grok-imagine-video-v1.5/image-to-video |
Endpoint
POST /api/generateRequest body
| Parameter | Type | Required | Description |
|---|---|---|---|
modelKey | string | ✓ | One of the model keys listed above |
prompt | string | ✓ | Text description of the image to generate |
inputUrl | string | Input image URL (for edit/i2i models) | |
aspectRatio | string | "1:1", "16:9", "9:16", etc. | |
imageQuality | string | "Low", "Medium", "High" | |
styleRef | string | string[] | Style reference image URL(s) | |
charRef | string | string[] | Character reference image URL(s) | |
brandId | string | Brand DNA ID for brand-consistent generation |
Code example
curl -X POST https://api.oyefilmy.com/api/generate \
-H "Authorization: Bearer of_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"modelKey": "grok_imagine_video_t2v",
"prompt": "A dramatic aerial view of a volcanic eruption at night, lava flowing into the ocean"
}'Response
{
"success": true,
"predictionId": "pred_abc123...",
"status": "processing",
"model": "xai/grok-imagine-video/text-to-video",
"creditCost": 5
}