一套接口,四种工作方式
从生成到二次创作,保持同一条任务链
视频请求不会占住浏览器连接。提交后保存 request_id,继续查询状态,完成后再预览或下载。
01
文生视频
输入场景、主体、镜头运动和节奏,异步生成一条短视频。
02
图生视频
上传一张主参考图,让静态画面获得动作、镜头和时间变化。
03
视频编辑
基于原视频和编辑指令生成新任务,不覆盖原始结果。
04
视频延长
从原视频结尾继续生成内容,并返回新的 request_id。
模型与规格
根据输入方式自动选择合适模型
纯文生、编辑和延长使用基础模型;带参考图的图生视频使用 1.5 模型。页面不会让用户选择无效组合。
| 模型 | 适用任务 | 分辨率 | 时长 |
|---|---|---|---|
| grok-imagine-video | 文生、编辑、延长 | 480p / 720p | 1–15s |
| grok-imagine-video-1.5 | 单图生视频 | 480p / 720p / 1080p | 1–15s |
异步接入
提交一次,按 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,可用于在线播放和拖动进度。
取消、删除、批量生成和多参考图当前尚未开放。
常见问题
继续了解 GetToken
比较套餐、查看接入指南,或继续了解产品与售后支持。
