Skip to main content
POST
cURL
这是 Grok 视频 API 的核心生成接口。 如果你想查看完整的接口目录、推荐接入流程和相关能力,请先阅读 Grok 视频 API 总览

授权

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 张)
  • 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
refer_images
string[]

垫图地址。grok-imagine-video-1.5-fast 支持多张垫图(最多 7 张);grok-imagine-video 支持多张垫图(单图最长 15 秒,多图最大 10 秒);grok-imagine-video-1.5 仅支持单张且必传。
['https://cdn.ttapi.io/other/2026-03-13/a86ca2c7-6333-4840-b337-395a5d02a182.png','https://cdn.ttapi.io/other/2026-03-13/64a858ed-6095-45ce-92d5-b515c9864703.png']

hook_url
string

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

示例:

"https://example.com/callback"

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

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