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

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

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

在 Vercel AI SDK 中，将providerOptions.xai.mode设置为"edit-video"，并通过providerOptions.xai.videoUrl传入源视频 URL，即可触发 video editing。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);

Video Generation，根据文本 prompt 生成视频
Image-to-Video，让静态图像动起来
Video Extension，扩展现有视频
API Reference，完整的 endpoint 文档
Imagine API Landing Page，查看 Imagine API 的实际效果

模型能力

Video Editing

并发请求

并发请求

相关内容