工具配置
视频生成 API 接入指南
使用 GetToken 中转服务调用 Grok 视频生成接口,完成文生视频、图生视频、编辑与延长任务。
- 更新于
- 最近核验
- 维护方
- GetToken 文档维护组
GetToken 提供基于 Grok 的视频生成中转接口,支持文生视频、图生视频、视频编辑和视频延长。所有接口统一走 /v1/videos 路径,使用 service_type=video_api 的专用 API Key。
前提条件
- 已登录 GetToken 控制台。
- 已创建
video_api专用 API Key(在控制台「视频 API」页面创建)。 - 已了解 base_url 与线路选择(见 base_url 与线路选择)。
接口地址
| 方法 | 路径 | 用途 |
|---|---|---|
| POST | /v1/videos/generations | 创建视频生成任务 |
| POST | /v1/videos/edits | 基于原视频创建编辑任务 |
| POST | /v1/videos/extensions | 从原视频结尾继续生成 |
| GET | /v1/videos/{request_id} | 查询任务状态 |
| GET | /v1/videos/{request_id}/content | 播放或下载完成结果 |
模型与规格
| 模型 | 类型 | 支持分辨率 |
|---|---|---|
grok-imagine-video | 文生视频 | 480p、720p |
grok-imagine-video-1.5 | 图生视频 | 480p、720p、1080p |
- 时长范围:1–15 秒
- 结果保留:24 小时,请及时下载
快速调用示例
bash
curl https://api.gettoken.dev/v1/videos/generations \
-H "Authorization: Bearer YOUR_VIDEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-video",
"prompt": "A quiet city street after rain",
"resolution": "720p",
"duration": 8
}'
返回 request_id 后,轮询状态接口直到任务完成,再调用内容接口获取视频。
费用说明
视频按实际生成时长计费,具体单价以控制台「视频 API」页面的实时报价为准。提交任务前可在页面中按模型、分辨率和时长预估费用。
注意事项
- 视频 Key 与普通文本 Key、生图 Key 分开管理,不能混用。
- 状态查询和内容下载必须使用创建任务时的同一把 Key。
- 取消、批量生成和多参考图当前不开放。