跳转到主要内容
POST
/
grok
/
v1
/
videos
/
generations
cURL
curl --request POST \
  --url https://api.ttapi.io/grok/v1/videos/generations \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "model": "grok-imagine-video-1.5-preview",
  "duration": 8,
  "image": {
    "url": "<string>"
  },
  "reference_images": [
    {
      "url": "<string>"
    }
  ]
}
'
{
  "request_id": "41eb9a5f-cbd4-9f21-8d59-79005f1e61b7"
}

授权

TT-API-KEY
string
header
必填

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

请求体

application/json
prompt
string
必填

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

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

使用的模型名称。

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

"grok-imagine-video-1.5-preview"

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-preview 模型必须传入(仅支持图生视频);grok-imagine-video 模型可选,传入时执行图生视频,不传时执行文生视频。

reference_images
object[]

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

resolution
enum<string>

视频分辨率。

可用选项:
480p,
720p

响应

请求成功

request_id
string
必填

请求ID

示例:

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

最后修改于 2026年6月10日