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

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

要求	取值
模型	`grok-imagine-video`
源视频	`.mp4`，采用受支持的编解码器，如 H.264、H.265 或 AV1
源视频时长	最多 8.7 秒
输出	时长、宽高比和分辨率与源视频一致，分辨率上限为 720p
`duration`、`aspect_ratio`、`resolution`	不支持

grok-imagine-video 会应用你描述的修改，并尽可能保留源视频的其他内容。请像以下提示词一样说明哪些内容必须保持不变：

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

并发请求

需要对同一段源视频执行多种编辑时，可以并发发送请求。

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

const sourceVideo = "https://media.x.ai/v1/docs/i2v-portrait-wave-4cb4c17c.mp4";

const 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",
];

const results = await Promise.all(
    prompts.map(prompt =>
        generateVideo({
            model: xai.video("grok-imagine-video"),
            prompt,
            providerOptions: {
                xai: {
                    mode: "edit-video",
                    videoUrl: sourceVideo,
                    pollTimeoutMs: 600000,
                } satisfies XaiVideoModelOptions,
            },
        }),
    ),
);

prompts.forEach((prompt, i) => {
    console.log(`${prompt}: ${results[i].providerMetadata?.xai?.videoUrl}`);
});

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://media.x.ai/v1/docs/i2v-portrait-wave-4cb4c17c.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())

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

最后更新：2026 年 10 月 9 日

从写代码，到创作下一幕

Agent Plan & Coding Plan

Seedance 2.5

模型能力

视频编辑

并发请求

并发请求

相关内容