Skip to main content

Documentation Index

Fetch the complete documentation index at: https://doc.deepwl.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
Grok Video

The Grok video series currently provides two integration methods: OpenAI-compatible /v1/videos (primarily multipart/form-data), and the unified video /v1/video/* and /v1/video/query (JSON).

​
OpenAI Format

Use POST /v1/videos to submit and GET /v1/videos/{task_id} to query, with support for derivative capabilities such as remix, extend, and extensions.

Grok Video Generation

POST /v1/videos, submit Grok video tasks via multipart.

Video Remix

POST /v1/videos/{video_id}/remix, perform a remix based on the original task.

Video Extend

POST /v1/videos/{video_id}/extend, extend the video from a specified timestamp.

Video Extensions

POST /v1/videos/extensions, reference the original task via video.url for extension.

Grok Task Query

GET /v1/videos/{task_id}, query an OpenAI-style video object.

​
Supported Models (OpenAI Format)

ModelDescriptionDuration Rule
grok-video-3Standard version, supports text-to-video, first frame, first and last frame, and reference-based video generationAs passed in the request
grok-video-3-proPro versionFixed 10s
grok-video-3-maxMax versionFixed 15s

​
Unified Video

Use POST /v1/video/create to create tasks, and support derivative capabilities such as POST /v1/video/remix, POST /v1/video/extend, and POST /v1/videos/extensions; query via GET /v1/video/query?id=.

Create Video

POST /v1/video/create, submit Grok tasks in the unified video format.

Video Remix

POST /v1/video/remix, pass task_id in the body.

Video Extend

POST /v1/video/extend, pass task_id and start_time in the body.

Video Extensions

POST /v1/videos/extensions, set video.url in the body to the original task ID.

Query Task

GET /v1/video/query, query status and results by task id.

​
Common Capabilities (Unified Video)

CapabilityParameter MethodDescription
Text-to-videoimages: []Text prompt only
First and last frameimages with 2 images in orderFirst frame + last frame
Multi-image referenceMultiple images + @imgNReference the corresponding images in prompt

​
Comparison

ItemOpenAI FormatUnified Video
CreatePOST /v1/videosPOST /v1/video/create
RemixPOST /v1/videos/{video_id}/remixPOST /v1/video/remix (task_id)
ExtendPOST /v1/videos/{video_id}/extendPOST /v1/video/extend (task_id)
ExtensionsPOST /v1/videos/extensionsPOST /v1/videos/extensions (video.url)
QueryGET /v1/videos/{task_id}GET /v1/video/query?id=
Request formatmultipart/form-dataJSON
Reference imageinput_referenceimages
Aspect ratioaspect_ratioaspect_ratio
Resolutionsize (720P / 1080P)size (720P / 1080P)
Durationsecondsduration (default 10, supports 6/10/15)

​
Parameter Constraints (Common to Both)

FieldAvailable ValuesDescription
aspect_ratio16:9, 9:16, 2:3, 3:2, 1:1The unified video docs cover the full set of ratios; the OpenAI format currently commonly uses 2:3, 3:2, 1:1
size720P, 1080PResolution specifications