Grok Imagine

In this page's examples, {BASE_URL} is https://api.uniall.ai.

Updated: 2026-06-03

This document explains how to call Grok Imagine video model. user requires using this sitestable model and OpenAI compatibilityvideo task endpoint.

1. Model

Model	scenario	Billing basis
grok-imagine	text-to-video, image-to-video, reference-image-to-video, video editing, video extension	capability type, /Output video duration billing detail; image-to-video input image

For new integrations, use grok-imagine, input form and extra_body.operation Capability. this site's model list Model do not call.

2. Endpoint Overview

2.1 recommended: OpenAI compatibilityvideo task endpoint

POST /v1/videos
GET /v1/videos/{task_id}
GET /v1/videos/{task_id}/content

POST /v1/videos submit task, return video task ID. poll GET /v1/videos/{task_id} Status. task completed, read response URL,/v1/videos/{task_id}/content Get Video File.

2.2 compatibility: video task endpoint

POST /v1/videos/generations
GET /v1/videos/generations/{task_id}

POST /v1/video/generations
GET /v1/video/generations/{task_id}

Endpoint, new recommended /v1/videos.

2.3 Details

Authorization: Bearer sk-***
Content-Type: application/json

3. fast

	recommendedModel		Capability
promptgenerate video	grok-imagine	prompt+duration
oneimage	grok-imagine	prompt+image+duration
multiple reference imagesgenerate video	grok-imagine	prompt+images+duration
editing video	grok-imagine	prompt+video+extra_body.operation=edit_video, recommended extra_body.input_video_seconds	edit_video
video	grok-imagine	prompt+video+duration+extra_body.operation=video_extend, recommended extra_body.input_video_seconds	video_extend

Note: extra_body.operation Yesthis sitestableCapability. input form the platform; video editingand pass video, recommended pass extra_body.operation.

4. Parameter Reference

Parameters	Type	Required	Note
model	string	Yes	always pass grok-imagine
prompt	string	Yes	video generation, editingor prompt
image	string/object	image-to-videoRequired	single image URL; supports {"url": "..."}
images	string[]	multiple reference imagesRequired	multiple reference images URL
image_url/image_urls	string/string[]	No	image compatibility field
video	string/object	editing/ Required	video URL; supports {"url": "..."}
videos	string[]	No	reference video URL array, reference video Capability
size	string	No	,480p, 720p; video extension does not support Parameters
aspect_ratio	string	No	output aspect ratio; text-to-video 16:9, 1:1, 9:16, single-image-to-video auto
duration	integer/string	Conditional	duration., multiple reference images and use; video editing do not pass Field
seconds	string	Conditional	OpenAI compatibilitydurationField; pass duration pass seconds, do notand duration pass both
extra_body.operation	string	No	stableCapability:text_to_video, image_to_video, reference_to_video, edit_video, video_extend
extra_body.input_video_seconds	integer	editing/ recommended to pass	video billing detail duration, passpositive integer. video duration recommended to pass; pass the platform oruse value

5. duration rules, multiple reference images and pass duration. video editing do not pass duration.

scenario	durationField	supports value	video duration
text-to-video	duration or seconds	1-15 integer seconds	requires
single-image-to-video	duration or seconds	1-15 integer seconds	requires
reference-image-to-video	duration or seconds	1-10 integer seconds	requires
video editing	pass duration/seconds		recommended to pass extra_body.input_video_seconds
video extension	duration or seconds	2-10 integer seconds	recommended to pass extra_body.input_video_seconds

Note:

• recommended to use duration, "duration": 6.
• If can onlyuse OpenAI compatibility field, pass seconds, "seconds": "6".
• duration and seconds one of two required, do not pass both.
• video editingand extra_body.input_video_seconds Yes video duration, Yes duration.
• If video duration, pass extra_body.input_video_seconds; the platform video, billing detail duration.
• billing detail userpass, Yes task / duration.

6. Capability Rules

requires pass extra_body.operation:

• imageandvideo: text-to-video.
• one image: image-to-video.
• images: reference-image-to-video.
• video: recommended pass edit_video or video_extend.

editing video:

{
  "extra_body": {
    "operation": "edit_video",
    "input_video_seconds": 8
  }
}

video:

{
  "duration": 6,
  "extra_body": {
    "operation": "video_extend",
    "input_video_seconds": 8
  }
}

7. Request Examples

7.1 text-to-video

curl -X POST "{BASE_URL}/v1/videos" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "grok-imagine",
 "prompt": " camera, fast, camera. ",
 "size": "720p",
 "aspect_ratio": "16:9",
 "duration": 6}'

submitresponses:

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "grok-imagine",
  "status": "queued",
  "progress": 0,
  "created_at": 1773980459,
  "seconds": "6"
}

7.2 single-image-to-video

curl -X POST "{BASE_URL}/v1/videos" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "grok-imagine",
 "prompt": " camera, camera. ",
 "image": "https://example.com/portrait.png",
 "size": "480p",
 "aspect_ratio": "auto",
 "duration": 10}'

7.3 reference-image-to-video

curl -X POST "{BASE_URL}/v1/videos" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "grok-imagine",
 "prompt": " @Image1 @Image2, slow camera push-in. ",
 "images": ["https://example.com/person.png",
 "https://example.com/street.png"],
 "size": "720p",
 "aspect_ratio": "4:3",
 "duration": 10}'

7.4 video editing

curl -X POST "{BASE_URL}/v1/videos" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "grok-imagine",
 "prompt": "to change videointo, reserved action and. ",
 "video": "https://example.com/source.mp4",
 "size": "720p",
 "extra_body": {"operation": "edit_video",
 "input_video_seconds": 8}}'

video editing do not pass duration/seconds. If video duration, recommended to pass extra_body.input_video_seconds, and; pass the platform oruse value.

7.5 video extension

curl -X POST "{BASE_URL}/v1/videos" \
 -H "Authorization: Bearer sk-***" \
 -H "Content-Type: application/json" \
 -d '{"model": "grok-imagine",
 "prompt": " camera, video and Orientation. ",
 "video": "https://example.com/source.mp4",
 "duration": 6,
 "extra_body": {"operation": "video_extend",
 "input_video_seconds": 8}}'

video extension duration duration, supports 2-10. If video duration, recommended to pass both extra_body.input_video_seconds.

8. Task Status And Result

After creation, save id or task_id, then poll GET /v1/videos/{task_id} until the task reaches completed or failed. See Video Generation Overview for the shared polling interval, status fields, error contract, result URL, and authenticated download flow.

9. Billing Notes

Grok video this siteuse billing detail, publicpricing Model.

scenario	billing detail
text-to-video	Resolution tier, Output video duration
single-image-to-video	Resolution tier, Output video duration
reference-image-to-video	Resolution tier, Output video duration
video editing	Resolution tier, video duration, Output video duration
video extension	video duration, Output video duration

public " Parameters "and,:

• video:
• video 480P:
• video 720P:

image-to-videoand reference-image-to-video Input image facts, Grok videoRules to change.

submit. tasksubmit balance, Yesto change value public.

10. Common Errors

to changevideo model imageEndpoint

grok-imagine call /v1/videos, do not /v1/images/generations.

editingand only pass video. editingpass: