--- title: AI Gateway Video Editing product: vercel url: /docs/ai-gateway/modalities/video-generation/video-editing canonical_url: "https://vercel.com/docs/ai-gateway/modalities/video-generation/video-editing" last_updated: 2026-09-08 type: how-to prerequisites: - /docs/ai-gateway/modalities/video-generation - /docs/ai-gateway/modalities related: - /docs/ai-gateway/modalities/video-generation summary: Edit existing videos using text prompts with Grok Imagine Video through AI Gateway. install_vercel_plugin: npx plugins add vercel/vercel-plugin --- # AI Gateway Video Editing Edit existing videos using text prompts. Describe the changes you want and the model modifies the video accordingly. ## Related pages > **For AI agents:** Follow these links to understand how this page connects to the rest of the Vercel ecosystem. For the full cross-link map (inbound, outbound, prerequisites, and semantic neighbors), see the .graph.md link below. - [Grok Imagine Video on AI Gateway](https://vercel.com/changelog/grok-imagine-video-on-ai-gateway?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) - [Video Generation with AI Gateway](https://vercel.com/blog/video-generation-with-ai-gateway?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) - [Generate videos with AI SDK](https://vercel.com/kb/guide/ai-sdk-video-generation?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) — Use experimental_generateVideo in the AI SDK to generate videos from a text prompt or an image, set aspect ratio, resolu - [AI Gateway now supports asynchronous video generation](https://vercel.com/changelog/ai-gateway-now-supports-asynchronous-video-generation?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) - [Grok Imagine Video 1.5 on AI Gateway](https://vercel.com/changelog/grok-imagine-video-1-5-on-ai-gateway?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) - [AI Gateway Video Extension](https://vercel.com/docs/ai-gateway/modalities/video-generation/video-extension?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) — Extend existing videos from their last frame with Grok Imagine Video through AI Gateway. - [Veo video models on AI Gateway](https://vercel.com/changelog/veo-video-models-on-ai-gateway?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) - [Video Generation Quickstart](https://vercel.com/docs/ai-gateway/getting-started/video?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=related) — Generate a video from a text prompt using AI Gateway. Full cross-link map for this page: [/docs/ai-gateway/modalities/video-generation/video-editing.graph.md](/docs/ai-gateway/modalities/video-generation/video-editing.graph.md?from=related&source_path=%2Fdocs%2Fai-gateway%2Fmodalities%2Fvideo-generation%2Fvideo-editing&source_site=vercel-docs&relationship=graph) Every model here also runs as a background job instead of one long-lived request. See [asynchronous generation](#asynchronous-generation) below. ## Grok Imagine Video Grok Imagine Video (by SpaceXAI) can edit existing videos using text prompts. Provide a source video URL and describe the desired edits. [Browse the latest Grok video models](/ai-gateway/models?capabilities=video-generation\&providers=spacexai) on the AI Gateway Models page. > **💡 Note:** Video editing output matches the input video's aspect ratio and resolution, > capped at 720p. A 1080p input will be downsized to 720p. The `duration`, > `aspectRatio`, and `resolution` parameters are not supported for editing. ### Grok parameters | Parameter | Type | Required | Description | | ----------------------------------------- | -------- | -------- | ---------------------------------------------------- | | `prompt` | `string` | Yes | Description of the edits to apply to the video | | `providerOptions.spacexai.videoUrl` | `string` | Yes | URL of the source video to edit | | `providerOptions.spacexai.pollIntervalMs` | `number` | No | How often to check task status. Defaults to `5000` | | `providerOptions.spacexai.pollTimeoutMs` | `number` | No | Maximum wait time. Defaults to `600000` (10 minutes) | ### Grok example ```typescript filename="video-editing.ts" import { experimental_generateVideo as generateVideo } from 'ai'; import fs from 'node:fs'; const result = await generateVideo({ model: 'spacexai/grok-imagine-video', prompt: 'Give the person sunglasses and a hat', providerOptions: { spacexai: { videoUrl: 'https://example.com/source-video.mp4', pollTimeoutMs: 600000, }, }, }); fs.writeFileSync('output.mp4', result.videos[0].uint8Array); ``` > **💡 Note:** Video generation can take several minutes. Set `pollTimeoutMs` to at least 10 > minutes (600000ms) for reliable operation. Generated video URLs are ephemeral > and should be downloaded promptly. ## Asynchronous generation Pass a `webhook` factory and the SDK registers your URL with the job instead of polling for it. The factory returns that URL and a `received` promise it waits on, then it fetches the videos itself. ```typescript filename="async-video-editing.ts" const result = await generateVideo({ model: gateway.videoModel('spacexai/grok-imagine-video'), prompt: 'Give the person sunglasses and a hat', providerOptions: { spacexai: { // Already a hosted URL, which is what the asynchronous flow needs. videoUrl: 'https://example.com/source-video.mp4', }, }, webhook: async () => ({ url: callbackUrl, received: waitForDelivery(token), }), poll: { timeoutMs: 10 * 60 * 1000 }, }); ``` The start request AI Gateway persists is capped at 300 KiB, so pass your source video as a hosted URL on this flow rather than inline data. `token`, `callbackUrl`, and `waitForDelivery` come from [webhook-driven completion](/docs/ai-gateway/modalities/video-generation#webhook-driven-completion), which also covers the receiver, signature verification, and the payload shape. *** --- [View full sitemap](/docs/sitemap)