Model
xai/grok-imagine-1.5-video
Modes
| Mode | How to activate | Description |
|---|---|---|
| Text-to-video (T2V) | Omit start_frame_image_url | Generate video from a text prompt. Optionally pass up to 7 reference images via image_urls |
| Image-to-video (I2V) | Provide start_frame_image_url | Animate a starting frame into video. Optionally pass additional reference images via image_urls (max 7 total across both fields) |
Parameters
| Parameter | Type | Required | Default | Allowed Values | Description |
|---|---|---|---|---|---|
prompt | string | Yes | — | 2–3000 chars | Video generation prompt |
start_frame_image_url | string | No | null | — | Start frame image URL for I2V mode |
image_urls | string[] | No | null | 1–7 URLs | Reference image URLs for style, subject, or scene guidance |
aspect_ratio | string | No | "auto" | "auto", "9:16", "3:4", "1:1", "4:3", "16:9", "21:9" | Output aspect ratio |
duration | int | No | — | 1–30 | Video length in seconds |
resolution | string | No | — | "480p", "720p" | Output resolution |
video_preset | string | No | "custom" | "custom", "spicy", "fun", "normal" | Generation style preset |
| Preset | Style |
|---|---|
custom | Default generation |
spicy | Extremely spicy/nsfw |
fun | Extremely crazy/fun |
normal | Normal style |
Example Request
Text to Video
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "xai/grok-imagine-1.5-video",
"input": {
"prompt": "A futuristic cityscape at sunset with flying cars",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9",
"video_preset": "custom"
}
}'
Image to Video
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "xai/grok-imagine-1.5-video",
"input": {
"prompt": "Camera slowly zooms in while clouds drift across the sky",
"start_frame_image_url": "https://example.com/start-frame.jpg",
"duration": 6,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}'
Text to Video with Reference Images
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "xai/grok-imagine-1.5-video",
"input": {
"prompt": "The character walks through a neon-lit alley at night",
"image_urls": [
"https://example.com/character-ref.jpg",
"https://example.com/style-ref.jpg"
],
"duration": 15,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}'
Response
{
"code": 200,
"success": true,
"data": {
"task_id": "abc123def456",
"status": "processing"
}
}