Video Edit

POST

https://api.cometapi.com/grok/v1/videos/edits

Maintainer:Not configured

Overview

Edit a video based on a text prompt. The model modifies the source video according to the instructions in your prompt while preserving the original structure and motion.

This endpoint is asynchronous — it returns a request_id immediately, which you can use to poll for the final result.

Source Video

The source video can be provided as:

A public URL pointing to a video file

Example:

{
  "prompt": "Add snow to the scene",
  "video": {
    "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-d2407257-5055-4813-9501-99f6f41889eb.mp4"
  },
  "model": "grok-imagine-video"
}

Querying the Result

Use the request_id to poll for the final video via the Get Video Generation Results endpoint:

GET /grok/v1/videos/{request_id}

Video editing is asynchronous, you may need to poll this endpoint multiple times until the task is complete.

Reference Documentation

For detailed parameter reference, see the xAI Official Documentation.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cometapi.com/grok/v1/videos/edits' \
--header 'Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "Add snow to the scene",
  "video": {
    "url": "https://vidgen.x.ai/xai-vidgen-bucket/xai-video-580ec0d5-b8d5-4ad0-b8af-89853facc1e5.mp4"
  },
  "model": "grok-imagine-video"
}'

Response Example

{
    "request_id": "a3d1008e-4544-40d4-d075-11527e794e4a"
}

Modified at 2026-02-28 10:11:33

Video Generation

Get video generation results

Video Edit

Overview#

Source Video#