Grok Video API

Grok Video API 提供高效的视频分析和生成能力，帮助开发者快速集成智能视频功能。

生成视频

POST https://api.ttapi.io/grok/generations

文字 & 图片生成视频

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
prompt	string	是	提示词
aspect_ratio	string	否	视频宽高比 可选值：2:3、3:2、1:1、9:16、16:9。 默认 16:9
video_length	string	否	视频时长 取值范围为 10 到 30。 默认 10
resolution_name	integer	否	输出分辨率，当前仅支持 720p。 默认 720p
refer_image	string	否	垫图地址 推荐垫图比例与视频宽高比例一致
hook_url	string	否	回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与fetch结构一致。如果未设置，则需要请求fetch接口进行查询。

Response

200

{
    "data": {
        "jobId": "3b178ca1-78ee-41c1-94d7-3464b27a2439"
    },
    "message": "success",
    "status": "SUCCESS"
}

400

查询任务结果

GET https://api.ttapi.io/grok/fetch

通过jobId查询当前任务生成结果

Headers

Name	Value
Content-Type	application/json
TT-API-KEY	用于请求授权 TT-API 的API密钥

Body

参数	类型	是否必须	描述
jobId	String	是	生成的视频的jobId

Response

200

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "c822d894-fba8-4cd7-8b34-5cf54284af61",
    "data": {
        "videoId": "video_b96164dd8bfa43518c858bcf",
        "prompt": "镜头不动，石灯上的蚂蚁正在爬行，背景的花草随风有微微的晃动，背景音乐有蝉鸣的声音",
        "aspectRatio": "9:16",
        "videoLength": "30",
        "resolutionName": "720p",
        "referImage": "https://api.nananobanana.cn/api/cos-proxy/default-tenant-001/images/a515af9c-1619-42e8-abc7-97a6792ec524.png",
        "videoUrl": "https://cdn.ttapi.io/other/2026-03-10/56a8bece963a4e8e9a585f41c5d24162.mp4",
        "quota": "9",
        "finishTime": "2026-03-10 09:52:59",
        "hookUrl": null
    }
}

结果参数详解

参数	详解
status	结果状态， ON_QUEUE：执行中 SUCCESS：成功 FAILED：失败
message	成功失败信息
data.quota	实际消耗额度