Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create an xAI video edit job

Start a Grok video editing job from a source MP4 and a natural-language edit instruction. Poll the same query endpoint used by video generation.

post/grok/v1/videos/edits

Request body

promptstring required

Edit instruction describing the change you want.

modelstring

xAI video model id.

outputobject

Optional output delivery configuration.

userstring

Optional end-user identifier.

Example request

{
  "prompt": "Add snow to the scene.",
  "model": "grok-imagine-video"
}

Response

Request accepted.

request_idstring required

Deferred request id used for polling.

Example response

{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}