Skip to main content
POST
cURL
使用此端点可通过文本指令编辑现有 MP4。与全新生成请求相比,输出会更贴近源片段的时序和构图。

发送请求之前

  • 提供可访问的 video.url
  • 保持源片段较短;xAI 官方建议将编辑时长限制在约 8.7 秒以内
  • 使用聚焦的指令,描述一个明确的改动
  • 保存返回的 request_id,因为编辑使用与生成相同的轮询流程

编辑流程

1

提交编辑请求

发送源视频 URL、编辑 Prompt 和 model: grok-imagine-video
2

轮询最终结果

调用获取 xAI 视频结果,直到任务完成。
3

存储编辑后资源

下载已完成的输出,或将返回的 URL 转入你自己的存储流程。

CometAPI 上的变化

xAI 将视频编辑文档描述为与生成相同的异步生命周期,只是将可选的源图像替换为源视频。CometAPI 保持了这一行为以及相同的轮询端点,因此你的编辑工作流仍然是“启动 -> 轮询 -> 下载”。

授权

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json
prompt
string
必填

Edit instruction describing the change you want.

示例:

"Add snow to the scene."

video
object
必填

Source video to edit. xAI documents an input limit of about 8.7 seconds.

model
string
默认值:grok-imagine-video

xAI video model id.

示例:

"grok-imagine-video"

output
object

Optional output delivery configuration.

user
string

Optional end-user identifier.

响应

200 - application/json

Request accepted.

request_id
string
必填

Deferred request id used for polling.