OpenAI 兼容层

编辑视频

用提示词修改一个已有视频，只改你要求的部分，其余画面保持不变。异步接口，提交后轮询。

POST/v1/videos/edits

端点

POST /v1/videos/edits
GET  /v1/videos/{task_id}        # 轮询，见「查询视频任务」

同一能力在原生透传层的写法见 编辑视频（原生透传）。

请求

必填 model、prompt、video 三个字段：

curl -X POST https://api.wxiai.com/v1/videos/edits \
  -H "Authorization: Bearer $WXIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "给画面里的人戴一顶黑色宽檐帽",
    "video": {"url": "https://example.com/source.mp4"}
  }'

video 支持三种给法，和图片一样：

形式	例子
公网 URL	{"url": "https://example.com/source.mp4"}
base64 data URI	{"url": "data:video/mp4;base64,..."}
xAI 文件 ID	{"file_id": "file-abc123"}

源视频必须是 .mp4

链接要带 .mp4 后缀，编码用 H.265 / H.264 / AV1 等 mp4 支持的编码。

请求参数

参数	必填	说明
model	是	视频模型，编辑用 grok-imagine-video
prompt	是	要改成什么样
video	是	源视频对象
storage_options	否	把产物存进 xAI 文件服务，见总览
user	否	你自己终端用户的标识

这三个参数传了也不会生效

参数	实际行为
duration	忽略，输出时长继承源视频（上限 8.7 秒）
aspect_ratio	忽略，输出比例继承源视频
resolution	忽略，输出分辨率继承源视频，上限 720p（1080p 输入会被降到 720p）

返回

提交时：

{
  "task_id": "d97415a1-5796-b7ec-379f-4e6819e08fdf",
  "status": "queued"
}

字段	说明
task_id	兼容层的任务 ID，查结果时要用它
status	提交后是 queued（排队）或 processing（生成中）

字段含义、状态机与失败错误码见 查询视频任务（OpenAI 兼容）。

接下来：用 GET 查结果

本页只负责启动任务。提交成功后拿到的 task_id 就是查结果的凭据，交给：

GET /v1/videos/{task_id}

状态值、失败错误码、下载方式全部在 查询视频任务 一处说明，不用在本页找。

这一层的注意点

• 别调 duration：编辑不支持自定义时长，输出时长永远继承源视频。
• 源视频必须带 .mp4 后缀：只写编码格式不带后缀会被拒绝。
• 分辨率会被压到 720p：1080p 源视频输出也会降到 720p，别指望保持原清晰度。
• 编辑能力挑模型：不是所有视频模型都支持编辑，报 failed_precondition 就换 grok-imagine-video。

相关页

• 视频生成总览 —— 编辑模式的参数边界与轮询状态机
• 编辑视频（原生透传） —— 同一能力的另一条路径
• 查询视频任务（OpenAI 兼容）
• 生成视频（OpenAI 兼容） · 扩展视频（OpenAI 兼容）