Skip to main content
POST
cURL
这是 Grok 视频 API 的文生视频接口。仅通过 prompt 生成视频,不传入任何媒体文件。
注意:不允许 NSFW 内容。单次或偶尔的审核失败不会产生任何费用,但反复触发审核失败可能会产生扣费。

授权

TT-API-KEY
string
header
必填

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

请求体

application/json

文生视频请求参数

prompt
string
必填

提示词。grok-imagine-videogrok-imagine-video-1.5 最大长度为 4096 字符;grok-imagine-video-1.5-fast 支持更长提示词。

model
enum<string>
默认值:grok-imagine-video-1.5-fast

模型名称。

  • grok-imagine-video-1.5-fast:时长支持 6-30 秒(6 秒、10 秒为标准时长;不支持 7 秒和 11 秒);支持多张垫图(最多 7 张);支持首尾帧控制
  • grok-imagine-video:时长支持 1-15 秒,支持多张垫图(单图最长 15 秒,多图最大 10 秒),仅支持 720P
  • grok-imagine-video-1.5:时长支持 1-15 秒,仅支持单张垫图且必传
可用选项:
grok-imagine-video-1.5-fast,
grok-imagine-video,
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 秒为标准时长);grok-imagine-video 取值范围为 1 到 15(单图最长 15 秒,多图最大 10 秒);grok-imagine-video-1.5 取值范围为 1 到 15。

resolution_name
enum<string>
默认值:720p

输出分辨率。480p 和 720p 支持全部模型;1080P 仅 grok-imagine-video-1.5 支持。

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

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

示例:

"https://example.com/callback"

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

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