Skip to main content

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)

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)

Comparison

Parameter Constraints (Common to Both)