Skip to main content
POST
cURL

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
prompt
string
必填

视频生成提示词。grok-imagine-video 模型支持文生视频时必填;grok-imagine-video-1.5 模型可选。

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

使用的模型名称。

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

"grok-imagine-video-1.5"

aspect_ratio
enum<string>

视频宽高比。

可用选项:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
duration
integer
默认值:8

视频时长(秒)。范围:[1, 15]。默认:8。同时接受数字(8)和字符串("8")格式。

必填范围: 1 <= x <= 15
image
object

图生视频时使用的图片对象。grok-imagine-video-1.5 模型必须传入(仅支持图生视频);grok-imagine-video 模型可选,传入时执行图生视频,不传时执行文生视频。

reference_images
object[]

参考生视频(R2V)时使用的参考图片数组。提供这些图片作为风格/内容参考来生成视频。

resolution
enum<string>

视频分辨率。

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

响应

请求成功

request_id
string
必填

请求ID

示例:

"41eb9a5f-cbd4-9f21-8d59-79005f1e61b7"

最后修改于 2026年6月4日