Grok 视频编辑与续写：官方参数参考

了解 Grok 如何修改现有视频或从末帧延长内容，以及两种操作不同的素材、时长和参数要求。

适用范围与功能

本页说明 xAI 官方能力；本站本目录暂未提供对应可调用入口，接入前请查看接入说明。旧 /v1/video/extend 请求不能继续作为本站 Grok 续写示例。

编辑用于改变原视频中的服饰、物体或场景，保留原片的时长。续写从原视频末帧继续生成，返回包含原片和新增片段的完整视频。

官方动作	输入长度	输出规则
编辑	最长 8.7 秒	保留原时长与比例，最高 720p。
续写	2–15 秒	新增 2–10 秒，默认 6 秒；保留输入比例，最高 720p。

官方编辑与续写示例使用 grok-imagine-video。1.5 的文生、图生能力不能直接推导出它支持相同编辑或续写操作。

输入为 MP4，编码可为 H.264、H.265、AV1 等 MP4 支持的编码。公开 URL 必须能被服务端读取；也可按 xAI 的要求使用 Base64 Data URI 或其 Files 服务的 file_id。

编辑：POST https://api.x.ai/v1/videos/edits。

续写：POST https://api.x.ai/v1/videos/extensions。

两者使用 JSON 请求体及 xAI 的 Bearer 凭据。本站 API 基础地址和凭据分别为 https://top.qingyuntop.ai 与青云TOP API Key；不能替换域名后照搬这两个原生接口。

字段	类型·必填	取值与说明
`model`	string / null；可选	官方示例使用 grok-imagine-video；建议明确填写。
`output`	null / object；可选	自定义输出目的地；upload_url 为必填字符串，使用签名 HTTP PUT 地址。可省略。
`prompt`	string；必填	必须填写希望改变的内容，例如服饰、物体或场景。
`storage_options`	null / object；可选	xAI Files 存储配置；无需定制存储时省略，不代表本站提供相同存储服务。
`user`	string / null；可选	应用的终端用户标识，不是 API Key。
`video`	object；必填	待编辑的视频对象，必填；素材不超过 8.7 秒。

字段	类型·必填	取值与说明
`duration`	integer / null；可选	新增片段 2–10 秒，默认 6 秒；不包含原片时长。
`model`	string / null；可选	官方示例使用 grok-imagine-video；建议明确填写。
`output`	null / object；可选	自定义输出目的地；upload_url 为必填字符串，使用签名 HTTP PUT 地址。可省略。
`prompt`	string；必填	描述原片结束后应该继续发生什么。
`storage_options`	null / object；可选	xAI Files 存储配置；无需定制存储时省略。
`video`	object；必填	原始视频对象，必填；输入时长为 2–15 秒。

video 是对象。填写 video.url 或 video.file_id 之一，不能用旧任务的 task_id 替代实际视频素材。

字段	类型·必填	取值与说明
`file_id`	string / null；可选	已上传完成的 xAI 视频文件 ID；与 url 互斥，不是任务 ID。
`url`	string；可选	MP4 的公开 URL 或 Base64 Data URI；未填写 file_id 时必填，与 file_id 互斥。

续写的 duration 只表示新增部分。例如输入 10 秒、续写 5 秒，完整输出为 15 秒。续写没有旧示例中的 start_time 和 upscale 字段；不能用它指定从原片第几秒开始或要求放大。

编辑不接受自定义 duration、aspect_ratio、resolution；续写不接受自定义 aspect_ratio、resolution。不要把创建新视频的参数表整套复制过来。

两种操作均是异步任务。原生接口返回 request_id 后，使用原生查询流程取得结果；创建被接受不等于视频已经完成。详见任务状态与结果。

如需连续续写，先检查上一步的实际输出时长；输出超过 15 秒时，不能直接把整段当作下一次续写的合法输入。需要先在自己的媒体处理流程中准备符合长度要求的素材。

素材过长时按当前动作的上限截取；下载失败时检查素材 URL 是否到期或需要登录；收到能力或规格错误时核对模型、动作和分辨率，不要反复重交同一个不合法请求。