提供源视频和 prompt，即可编辑现有视频。模型会理解视频内容并应用你要求的更改。

源视频可以是公开 URL、Base64 编码的数据 URI，或来自 file_id 的 Files API。有关如何使用 Imagine → Files API Integration 作为输入，请参阅 file_id 输入。

下方演示展示了视频编辑的实际效果。grok-imagine-video能够在强力保留场景的同时实现高保真编辑，只修改你要求的内容，并保持视频其余部分不变：

在 Vercel AI SDK 中，将providerOptions.xai.mode设置为"edit-video"，并通过providerOptions.xai.videoUrl 传入源视频 URL，即可触发视频编辑。 prompt 用于描述所需修改；duration、aspectRatio和resolution 会被忽略，因为输出会继承输入视频的这些属性，最高为 720p。

并发请求

需要对同一个源视频应用多项编辑时，请并发运行请求。这适合从同一个中间结果分支出多个编辑版本。

import os
import asyncio
import xai_sdk

async def edit_concurrently():
    client = xai_sdk.AsyncClient(api_key=os.getenv("XAI_API_KEY"))

    source_video = "https://data.x.ai/docs/video-generation/portrait-wave.mp4"

    prompts = [
        "Give the woman a silver necklace",
        "Change the color of the woman's outfit to red",
        "Give the woman a wide-brimmed black hat",
    ]

    tasks = [
        client.video.generate(
            prompt=prompt,
            model="grok-imagine-video",
            video_url=source_video,
        )
        for prompt in prompts
    ]

    results = await asyncio.gather(*tasks)

    for prompt, result in zip(prompts, results):
        print(f"{prompt}: {result.url}")

asyncio.run(edit_concurrently())

import { xai, type XaiVideoModelOptions } from "@ai-sdk/xai";
import { experimental_generateVideo as generateVideo } from "ai";

const providerOptions = {
    xai: {
        mode: "edit-video",
        videoUrl: "https://example.com/source-video.mp4",
        pollTimeoutMs: 600000,
    } satisfies XaiVideoModelOptions,
};

const step1 = await generateVideo({
    model: xai.video("grok-imagine-video"),
    prompt: "Add a party hat to the person",
    providerOptions,
});

const step1VideoUrl = step1.providerMetadata?.xai?.videoUrl as string;

const [withSunglasses, withScarf] = await Promise.all([
    generateVideo({
        model: xai.video("grok-imagine-video"),
        prompt: "Add sunglasses",
        providerOptions: {
            xai: {
                mode: "edit-video",
                videoUrl: step1VideoUrl,
                pollTimeoutMs: 600000,
            } satisfies XaiVideoModelOptions,
        },
    }),
    generateVideo({
        model: xai.video("grok-imagine-video"),
        prompt: "Add a scarf",
        providerOptions: {
            xai: {
                mode: "edit-video",
                videoUrl: step1VideoUrl,
                pollTimeoutMs: 600000,
            } satisfies XaiVideoModelOptions,
        },
    }),
]);

console.log(withSunglasses.providerMetadata?.xai?.videoUrl);
console.log(withScarf.providerMetadata?.xai?.videoUrl);

视频生成：根据文本提示词生成视频
图像转视频：让静态图像动起来
视频扩展：扩展现有视频
API 参考：完整的端点文档
Imagine API 主页：展示 Imagine API 的实际效果

最后更新：2026 年 7 月 30 日

并发请求

相关内容