提供源视频和描述后续内容的文本提示词，即可扩展现有视频。结果是一段从输入视频最后一帧无缝衔接并继续生成内容的单一视频。

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

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

该 duration参数控制仅扩展部分 的长度，而不是总输出长度。例如，如果输入视频为 10 秒，并将 duration设为 5，则返回的视频长度为 15 秒（10 秒原视频 + 5 秒扩展）。

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

const source = await generateVideo({
    model: xai.video("grok-imagine-video-1.5"),
    prompt: "A cat sitting on a sunlit windowsill, tail gently swishing.",
    duration: 5,
    aspectRatio: "16:9",
    providerOptions: {
        xai: {
            pollTimeoutMs: 600000,
        },
    },
});

const sourceUrl = source.providerMetadata?.xai?.videoUrl;

const extended = await generateVideo({
    model: xai.video("grok-imagine-video"),
    prompt: "The cat turns its head, notices a butterfly, and leaps off.",
    duration: 6,
    providerOptions: {
        xai: {
            mode: "extend-video",
            videoUrl: sourceUrl,
            pollTimeoutMs: 600000,
        },
    },
});

const extendedVideoUrl = extended.providerMetadata?.xai?.videoUrl;
console.log(extendedVideoUrl);

import os
import time
import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.environ['XAI_API_KEY']}",
}

response = requests.post(
    "https://api.x.ai/v1/videos/extensions",
    headers=headers,
    json={
        "model": "grok-imagine-video",
        "prompt": "The shot pans to an over the shoulder perspective. Calm controlled scene.",
        "duration": 10,
        "video": {"url": "<VIDEO_URL>"},
    },
)

request_id = response.json()["request_id"]

while True:
    result = requests.get(
        f"https://api.x.ai/v1/videos/{request_id}",
        headers={"Authorization": headers["Authorization"]},
    )
    data = result.json()
    if data["status"] == "done":
        print(data["video"]["url"])
        break
    elif data["status"] in ("expired", "failed"):
        print(f"Request {data['status']}")
        break
    time.sleep(5)

# Start the video extension request
REQUEST_ID=$(curl -s -X POST https://api.x.ai/v1/videos/extensions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "The shot pans to an over the shoulder perspective. Calm controlled scene.",
    "duration": 10,
    "video": {"url": "<VIDEO_URL>"}
  }' | jq -r '.request_id')

# Poll until the video is ready
while true; do
  RESULT=$(curl -s https://api.x.ai/v1/videos/$REQUEST_ID \
    -H "Authorization: Bearer $XAI_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  if [ "$STATUS" = "done" ]; then
    echo "$RESULT" | jq -r '.video.url'
    break
  elif [ "$STATUS" = "failed" ] || [ "$STATUS" = "expired" ]; then
    echo "Request $STATUS"; echo "$RESULT" | jq .
    break
  fi
  sleep 5
done

import os
import xai_sdk

client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))

response = client.video.extend(
    prompt="The shot pans to an over the shoulder perspective. Calm controlled scene.",
    model="grok-imagine-video",
    video_url="<VIDEO_URL>",
    duration=10,
)

print(response.url)

延长视频以异步方式运行：

REST API：POST /v1/videos/extensions 会返回 request_id。轮询 GET /v1/videos/{request_id}，直到 status 为 done。
Python SDK：client.video.extend() 会自动轮询并返回完成的视频。
AI SDK：将 providerOptions.xai.mode设置为"extend-video"，并通过以下字段传入源视频：providerOptions.xai.videoUrl。结果的 URL 位于 providerMetadata.xai.videoUrl。

如果要修改视频内部发生的事件，参见视频编辑。

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

最后更新：2026 年 10 月 9 日

从写代码，到创作下一幕

Agent Plan & Coding Plan

Seedance 2.5

模型能力

视频扩展