Video Editing

Edit an existing video with a text prompt using POST /v1/videos/edits. Supply the source as video: {url | file_id}. The operation is asynchronous and polls the same GET /v1/videos/{request_id} endpoint.

CLI

progrok video edit "make the background a sunset sky" --video ./clip.mp4
progrok video edit "add cinematic color grading" --video file_id:file-abc123

API

curl -X POST http://localhost:18645/v1/videos/edits   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{
    "model": "grok-imagine-video",
    "video": {"url": "https://example.com/source.mp4"},
    "prompt": "Add cinematic color grading"
  }'

Limits

The source must be an MP4-compatible video and is capped at 8.7 seconds. Editing does not support custom duration, aspect_ratio, or resolution; output keeps the input duration/aspect and is capped at 720p.