Skip to main content
POST
cURL
这是 Grok 视频 API 的核心生成接口。
注意:不允许 NSFW 内容。单次或偶尔的审核失败不会产生任何费用,但反复触发审核失败可能会产生扣费。
如果你想查看完整的接口目录、推荐接入流程和相关能力,请先阅读 Grok 视频 API 总览

Authorizations

TT-API-KEY
string
header
required

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

Body

application/json
prompt
string
required

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

model
enum<string>
default: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 秒,仅支持单张垫图且必传
Available options:
grok-imagine-video-1.5-fast,
grok-imagine-video,
grok-imagine-video-1.5
Example:

"grok-imagine-video-1.5-fast"

aspect_ratio
enum<string>
default:16:9

视频宽高比

Available options:
2:3,
3:2,
1:1,
9:16,
16:9
video_length
string
default: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>
default:720p

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

Available options:
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']

first_frame
string

首帧图片地址。仅 grok-imagine-video-1.5-fast 支持。用于指定视频的第一帧。

last_frame
string

尾帧图片地址。仅 grok-imagine-video-1.5-fast 支持。用于指定视频的最后一帧。当 first_framelast_frame 传入同一张图片时,实现循环效果(loop)。

reference_audios
object[]

语音角色数组,最多可传 3 个。仅 grok-imagine-video-1.5 模型支持此参数。示例:[{"voice_id": "sirius"}]

Maximum array length: 3
Example:
hook_url
string

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

Example:

"https://example.com/callback"

Response

请求成功

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on September 2, 2026