跳转到主要内容
POST
/
grok
/
generations
cURL
curl --request POST \
  --url https://api.ttapi.io/grok/generations \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": [
    "2:3",
    "3:2",
    "1:1",
    "9:16",
    "16:9"
  ],
  "video_length": "10",
  "resolution_name": "720p",
  "refer_image": "<string>",
  "hook_url": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

授权

TT-API-KEY
string
header
必填

授权字段,控制台获取授权信息

请求体

application/json
prompt
string
必填

提示词

aspect_ratio
string
默认值:16:9

视频宽高比

示例:
["2:3", "3:2", "1:1", "9:16", "16:9"]
video_length
string
默认值:10

视频时长 取值范围为 10 到 30。

resolution_name
integer
默认值:720p

输出分辨率,当前仅支持 720p

refer_image
string

垫图地址
推荐垫图比例与视频宽高比例一致

hook_url
string

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

示例:

"https://example.com/callback"

响应

请求成功

status
string
必填
示例:

"SUCCESS"

message
string
必填
示例:

"success"

data
object
必填
示例:
{ "job_id": "job_id" }
Last modified on March 12, 2026