Grok 视频 API · 内测

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

创建 Grok 视频专用 API Key,提交文生视频或图生视频任务,按任务 ID 追踪异步结果。

视频专用 API Key
异步任务可追踪
结果保留 24 小时
带有时间残影的银灰色飞鸟

文生视频与图生视频,同一套接口

01

文生视频

描述场景、主体与镜头,生成一条短视频。

02

图生视频

上传一张参考图,让静态画面动起来。

提交一次,按任务 ID 追踪到完成

上游不提供任务列表接口,务必在自己的业务记录里保存返回的任务 ID。
1

创建并使用 Grok 视频专用 API Key 提交生成请求。

2

保存返回的任务 ID,并关联到自己的业务记录。

3

每 5–10 秒查询一次状态,直到任务完成。

4

通过内容接口播放或下载结果,并及时保存最终文件。

/v1/videos/generations

三个核心接口

POST/v1/videos/generations
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",
    "size": "1280x720",
    "seconds": "8"
  }'

规格与费用

模型适用任务验证状态尺寸时长额度消耗人民币估算
grok-imagine-video文生视频 / 图生视频上游接受480p · 848x480115s$0.50/s¥0.067–¥0.2/s
grok-imagine-video文生视频 / 图生视频已完成生成验证720p · 1280x720115s$0.70/s¥0.093–¥0.28/s
grok-imagine-video-1.5图生视频(需传参考图)上游接受480p · 848x480115s$0.80/s¥0.107–¥0.32/s
grok-imagine-video-1.5图生视频(需传参考图)已完成生成验证720p · 1280x720115s$1.40/s¥0.187–¥0.56/s
grok-imagine-video-1.5图生视频(需传参考图)上游接受1080p · 1920x1080115s$2.50/s¥0.333–¥1/s
115s
任务时长(秒)
1280×720
已完成付费验证
24h
结果保留时长
按量
提交前报价,按实际用量结算

人民币金额按价格页当前套餐购买力口径(1 USD ≈ ¥0.1333–¥0.40)估算。grok-imagine-video-1.5 的纯文本请求会降级为标准模型并按标准模型计费;带参考图时才使用 1.5。Preview 不在公开模型列表中,仅作为兼容入口。参考图支持 JPEG / PNG / WebP,单图不超过 60 MiB。最终扣费以提交前报价和控制台实际用量记录为准。

常见问题

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

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