Grok 视频 API · 内测

把短视频生成接入真实的生产流程

创建 Grok 视频专用 API Key,提交文生视频、图生视频、编辑或延长任务。任务异步执行,规格和预计费用在提交前清晰可见。

视频专用 API Key
异步任务可追踪
结果保留 24 小时
带有时间残影的银灰色飞鸟
一套接口,四种工作方式

从生成到二次创作,保持同一条任务链

视频请求不会占住浏览器连接。提交后保存 request_id,继续查询状态,完成后再预览或下载。

01

文生视频

输入场景、主体、镜头运动和节奏,异步生成一条短视频。

02

图生视频

上传一张主参考图,让静态画面获得动作、镜头和时间变化。

03

视频编辑

基于原视频和编辑指令生成新任务,不覆盖原始结果。

04

视频延长

从原视频结尾继续生成内容,并返回新的 request_id。

模型与规格

根据输入方式自动选择合适模型

纯文生、编辑和延长使用基础模型;带参考图的图生视频使用 1.5 模型。页面不会让用户选择无效组合。

模型适用任务分辨率时长
grok-imagine-video文生、编辑、延长480p / 720p115s
grok-imagine-video-1.5单图生视频480p / 720p / 1080p115s
异步接入

提交一次,按 request_id 追踪到完成

创建接口只负责接收任务。应用应保存任务编号并查询状态,不能依赖上游任务列表找回记录。

1

创建并使用 Grok 视频专用 API Key 提交生成、编辑或延长请求。

2

保存返回的 request_id,并在自己的业务记录中关联任务。

3

定期查询状态;未知状态保留任务编号并继续查询。

4

完成后通过内容接口播放或下载,及时保存最终文件。

五个核心接口

Web 接入统一使用 /v1 路径;查询状态和内容时继续使用创建任务的同一个 API Key。

POST/v1/videos/generations
POST/v1/videos/edits
POST/v1/videos/extensions
GET/v1/videos/{request_id}
GET/v1/videos/{request_id}/content
curl https://api.gettoken.dev/v1/videos/generations \
  -H "Authorization: Bearer $GETTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "A quiet city street after rain",
    "resolution": "720p",
    "duration": 8
  }'
费用与保留

提交前看预计费用,完成后以真实用量为准

预计费用由服务端根据模型、分辨率和时长实时报价。状态接口只有在明确返回实际费用时才展示最终扣费;否则继续标记为预计费用。

用户不需要选择或切换视频计费分组。

24h

结果完成后保留 24 小时,请在有效期内下载。

视频内容支持 HTTP Range,可用于在线播放和拖动进度。

取消、删除、批量生成和多参考图当前尚未开放。

常见问题

从一次可控的视频任务开始

创建视频专用 API Key,确认模型、分辨率、时长和预计费用,再进入工作台完成第一次生成。