视频编辑

文档版本：v1.1.0 | 最后更新：2026-07-10
本平台已完整适配 Grok (xAI) 官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

对已有视频进行编辑修改，如添加/替换物体、修改场景等。

编辑模式不支持自定义 duration、aspect_ratio、resolution，输出匹配输入视频属性（分辨率上限 720p，如输入 1080p 将被降为 720p）
输入视频格式：MP4（H.264/H.265/AV1 编码）
输入视频最大长度：8.7 秒
视频编辑仅 grok-imagine-video 支持，grok-imagine-video-1.5 不支持

创建任务

POST https://studio.dataeyes.ai/grok/v1/videos/edits

请求头

参数	类型	必填	默认值	说明
`Content-Type`	string	是	application/json	数据交换格式
`Authorization`	string	是		鉴权信息，参考接口鉴权

请求体

参数	类型	必填	默认值	说明
`model`	string	是	grok-imagine-video	模型标识视频编辑仅支持 `grok-imagine-video`
`prompt`	string	是		描述编辑内容的文本提示词
`video`	object	是		输入视频对象，须包含以下字段之一： `url` — 公开 URL 或 Base64 data URL `file_id` — xAI Files API 的文件 ID 示例：`{"url": "https://example.com/video.mp4"}` 注意：不接受裸字符串

请求示例

curl --request POST \
  --url 'https://studio.dataeyes.ai/grok/v1/videos/edits' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-video",
    "prompt": "一枚水晶能量火箭从火星红色沙丘上发射升空",
    "video": {"url": "https://example.com/video.mp4"}
  }'

响应示例

{
  "request_id": "req_abc123def456"
}

查询任务

GET https://studio.dataeyes.ai/grok/v1/videos/{request_id}

通过 request_id 轮询任务状态及结果。

请求头

参数	类型	必填	说明
`Authorization`	string	是	`Bearer {API_KEY}`

请求示例

curl --request GET \
  --url 'https://studio.dataeyes.ai/grok/v1/videos/{request_id}' \
  --header 'Authorization: Bearer <token>'

响应示例

成功（status: done）：

{
  "model": "grok-imagine-video",
  "progress": 100,
  "status": "done",
  "usage": {
    "cost_in_usd_ticks": 4200000000
  },
  "video": {
    "url": "https://vidgen.x.ai/.../video.mp4",
    "duration": 10,
    "respect_moderation": true
  }
}

处理中（status: pending）：

{
  "progress": 56,
  "status": "pending"
}

失败：

{
  "status": "failed",
  "error": {
    "code": "invalid_argument",
    "message": "Prompt cannot be empty. Please provide a prompt."
  }
}

查询响应字段

字段	类型	说明
`status`	string	任务状态：`pending`, `done`, `failed`, `expired`
`progress`	integer	生成进度（0-100）
`video.url`	string	生成的视频临时 URL（有效期 24 小时）
`video.duration`	integer	生成视频的时长（秒）
`video.respect_moderation`	boolean	内容是否通过审核；若为 false 则 url 为空
`model`	string	使用的模型
`usage.cost_in_usd_ticks`	integer	上游返回的计费金额，单位 usd_tick（1 tick = 10⁻¹⁰ 美元）
`error.code`	string	错误码
`error.message`	string	错误描述

错误处理

当视频生成失败时，响应包含 error 对象，含 code 和 message 字段。可能的错误码如下：

错误码	含义	处理建议
`invalid_argument`	请求参数无效（不支持的时长、无效的图片/视频、提示词过长、冲突的模式，或内容被审核拦截）	修正请求参数或输入媒体后重新提交
`permission_denied`	API 密钥无权执行请求的操作	确认 API 密钥权限
`failed_precondition`	当前模型或设置不支持请求的操作	更改模型、模式、分辨率或其他设置
`service_unavailable`	视频生成服务暂时过载	稍后重试
`internal_error`	服务内部错误	重试请求；如持续失败，携带 request_id 联系支持

鉴权错误、模型不存在和限流等错误在任务创建前同步返回，不会出现在上述异步错误码中。

04-视频编辑

视频编辑#

创建任务#

请求头#

请求体#

请求示例#

响应示例#

查询任务#

请求头#

请求示例#

响应示例#

查询响应字段#

错误处理#

视频编辑

创建任务

请求头

请求体

请求示例

响应示例

查询任务

请求头

请求示例

响应示例

查询响应字段

错误处理