Skip to main content
POST
cURL
这是 Grok 视频 API 的关键帧生视频接口。通过 keyframes 在视频中间指定关键帧图像,模型会在关键帧之间生成过渡画面。可与 first_frame(首帧)和 last_frame(尾帧)组合使用,支持以下组合方式:
  • 首帧 + 关键帧:指定视频开头和中间关键帧
  • 关键帧 + 尾帧:指定中间关键帧和视频结尾
  • 首帧 + 关键帧 + 尾帧:完整控制视频的首帧、中间关键帧和尾帧
支持 grok-imagine-video-1.5-fast 和 grok-imagine-video-1.5。
注意:不允许 NSFW 内容。单次或偶尔的审核失败不会产生任何费用,但反复触发审核失败可能会产生扣费。
关键帧限制:每个请求最多 4 个关键帧;timestamp_s 必须大于 0 且小于视频时长;关键帧之间至少间隔 1/3 秒。

授权

TT-API-KEY
string
header
必填

请前往 TTAPI 控制台 获取 API 密钥。

请求体

application/json

关键帧生视频请求参数

prompt
string
必填

提示词,用于引导关键帧之间的运动和镜头。可选。

keyframes
object[]
必填

关键帧数组。每个元素包含一个图片地址和对应的时间戳(秒)。最多 4 个关键帧。timestamp_s 必须大于 0 且小于视频时长,关键帧之间至少间隔 1/3 秒。

Maximum array length: 4
model
enum<string>
默认值:grok-imagine-video-1.5-fast

模型名称。

可用选项:
grok-imagine-video-1.5-fast,
grok-imagine-video-1.5
示例:

"grok-imagine-video-1.5-fast"

aspect_ratio
enum<string>
默认值:16:9

视频宽高比

可用选项:
2:3,
3:2,
1:1,
9:16,
16:9
video_length
string
默认值:10

视频时长(秒)。grok-imagine-video-1.5-fast 取值范围为 6 到 30(6 秒、10 秒为标准时长;不支持 7 秒和 11 秒);grok-imagine-video-1.5 取值范围为 1 到 15。

resolution_name
enum<string>
默认值:720p

输出分辨率。可选 480p、720p。

可用选项:
480p,
720p,
1080p
first_frame
string

首帧图片地址。用于严格指定视频的第一帧。可与 keyframes 和 last_frame 组合使用。

last_frame
string

尾帧图片地址。用于严格指定视频的最后一帧。可与 keyframes 和 first_frame 组合使用。当 first_frame 和 last_frame 传入同一张图片时,实现循环效果(loop)。

hook_url
string

回调地址,任务完成或失败将通过请地址进行通知,通知数据结构与fetch结构 [blocked]一致。如果未设置,则需要请求fetch接口 [blocked]进行查询

示例:

"https://example.com/callback"

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
示例:
最后修改于 2026年10月11日