Grok 视频生成

Grok 视频采用异步任务模式。提交接口立即返回 request_id，客户端通过查询端点轮询，状态完成后下载 video.url。

模型

常见生成模型标识：

模型	输出分辨率	当前用途
grok-imagine-video-1.5-720p	720p	图生视频
grok-imagine-video-1.5-1080p	1080p	图生视频

模型名中的分辨率会约束输出。请求前应通过 /v1/models 确认可用性。

1. 提交生成任务

POST https://api.topapis.cn/v1/videos/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

curl "https://api.topapis.cn/v1/videos/generations" \
  -H "Authorization: Bearer $TOPAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5-720p",
    "prompt": "镜头缓慢推进，主体转头看向窗外",
    "image": {
      "url": "https://example.com/first-frame.jpg"
    },
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

参数	类型	必填	说明
model	string	是	当前账号可用的 Grok 视频模型
prompt	string	是	主体动作和镜头运动描述
image	object	是	首帧 { "url": "..." } 或 { "file_id": "..." }
duration	integer	是	1 到 15 秒
aspect_ratio	string	否	默认 16:9

常用画幅包括 1:1、16:9、9:16、4:3、3:4、3:2 和 2:3。通道限制变化时，以接口错误和模型说明为准。

提交响应：

{
  "request_id": "request_example"
}

2. 轮询任务

GET https://api.topapis.cn/v1/videos/{request_id}
Authorization: Bearer YOUR_API_KEY

建议每 3 到 5 秒查询一次，并设置最长等待时间。

{
  "status": "done",
  "video": {
    "url": "https://example.com/output.mp4",
    "duration": 6
  },
  "model": "grok-imagine-video-1.5"
}

常见状态包括：

状态	操作
pending	继续轮询
done	读取并下载 video.url
failed	停止轮询并记录非敏感错误信息
expired	停止轮询，任务结果已不可用

编辑与续写端点

协议可能提供以下路径：

POST /v1/videos/edits
POST /v1/videos/extensions

当前列出的 1.5 生成模型只用于 generations，不应直接用于编辑或续写。只有 /v1/models 和账号通道明确提供对应模型时，才调用这些端点。

下载与保存

• video.url 可能过期，应在任务完成后及时下载。
• 下载请求使用独立超时，并验证状态码、内容类型和文件大小。
• 保存 request_id，应用重启后继续查询同一任务。
• 提交超时后先查询已有任务记录，避免无条件重复提交。