acedatacloud Grok Video Generation
Generate AI videos through AceDataCloud's Grok (xAI) API.
Setup: See authentication for token setup.
Quick Start
curl -X POST https://api.acedata.cloud/grok/videos \
-H "Authorization: ******" \
-H "Content-Type: application/json" \
-d '{"prompt": "a futuristic city at night with flying cars and neon lights", "model": "grok-imagine-video-1.5-fast:reverse", "callback_url": "https://api.acedata.cloud/health"}'
Async: See async task polling. Poll via
POST /grok/taskswith{"id": "..."}.
Models
| Model | Resolution | Default | Notes |
|---|---|---|---|
grok-imagine-video-1.5-fast:reverse |
up to 1080p | ✓ | Best value. 6–30s, billed by duration tier |
grok-imagine-video:reverse |
up to 1080p | Better value. 1–15s, billed per output second | |
grok-imagine-video:official |
up to 1080p | Higher quality. 1–15s, billed per output second | |
grok-imagine-video-1.5:official |
up to 1080p | Higher quality, image-to-video only (image_url required) |
|
grok-imagine-video |
up to 720p | Base model, text-to-video only | |
grok-imagine-video-1.5-preview |
up to 720p | 1.5 preview (grok-video.json surface) |
Workflows
1. Text-to-Video
Generate a video from a text description.
POST /grok/videos
{
"prompt": "a majestic eagle soaring over snow-capped mountains at dawn",
"model": "grok-imagine-video-1.5-fast:reverse",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 6
}
2. Image-to-Video
Animate a still image into motion. Provide the image URL via image_url.
POST /grok/videos
{
"prompt": "the eagle lifts off and flies into the sunset",
"image_url": "https://example.com/eagle.jpg",
"model": "grok-imagine-video:official",
"resolution": "720p",
"aspect_ratio": "16:9"
}
3. Multi-Reference Generation
Supply up to several reference images via reference_image_urls for style or subject consistency.
POST /grok/videos
{
"prompt": "the character walks through a cyberpunk alley",
"reference_image_urls": [
"https://example.com/character.jpg",
"https://example.com/style.jpg"
],
"model": "grok-imagine-video-1.5-fast:reverse",
"resolution": "1080p"
}
Parameters
| Parameter | Values | Description |
|---|---|---|
prompt |
string | Text description of the desired video |
model |
see Models table | Model to use (default: grok-imagine-video-1.5-fast:reverse) |
image_url |
URL | Single reference image for image-to-video |
reference_image_urls |
array of URLs | Multiple reference images for style/subject guidance |
aspect_ratio |
"1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3" |
Output aspect ratio |
resolution |
"480p", "720p", "1080p" |
Output resolution (default: 480p; 1080p only for :reverse/:official models) |
duration |
integer | Duration in seconds (default: 6) |
callback_url |
URL | Webhook URL for async delivery |
async |
boolean | Return a task ID immediately for polling |
Task Queries
POST /grok/tasks
{"id": "<task_id>", "action": "retrieve"}
Batch retrieval:
POST /grok/tasks
{"ids": ["<id1>", "<id2>"], "action": "retrieve_batch"}
Gotchas
1080presolution is only supported by:reverseand:officialmodel variantsimage_urlprovides a single driving image;reference_image_urlsprovides multiple style/subject references- Set
callback_urlto get the task ID immediately without blocking on completion - Poll
POST /grok/taskswith{"id": "..."}until a final video URL appears in the response
MCP: See MCP servers for tool-use integration.