# Grok Video API

{% hint style="danger" %}
此文档已停止维护，最新文档地址：<https://docs.ttapi.io>
{% endhint %}

## 生成视频

<mark style="color:green;">`POST`</mark> `https://api.ttapi.io/grok/generations`

> 文字 & 图片生成视频

**Headers**

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

**Body**

<table><thead><tr><th width="234">参数</th><th width="129">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>prompt</code></td><td>string</td><td>是</td><td>提示词</td></tr><tr><td><code>aspect_ratio</code></td><td>string</td><td>否</td><td>视频宽高比<br>可选值：2:3、3:2、1:1、9:16、16:9。<br>默认 16:9</td></tr><tr><td><code>video_length</code></td><td>string</td><td>否</td><td>视频时长<br>取值范围为 10 到 30。<br>默认 10</td></tr><tr><td><code>resolution_name</code></td><td>integer</td><td>否</td><td>输出分辨率，当前仅支持 720p。<br>默认  720p</td></tr><tr><td><code>refer_images</code></td><td>list</td><td>否</td><td><p>垫图地址</p><pre><code><strong>["https://cdn.ttapi.io/other/2026-03-13/a86ca2c7-6333-4840-b337-395a5d02a182.png",
</strong>"https://cdn.ttapi.io/other/2026-03-13/64a858ed-6095-45ce-92d5-b515c9864703.png"]
</code></pre></td></tr><tr><td><code>hook_url</code></td><td>string</td><td>否</td><td>回调地址，任务完成或失败将通过请地址进行通知，通知数据结构与<a href="#jie-guo-can-shu-xiang-jie">fetch结构</a>一致。如果未设置，则需要请求fetch接口进行查询。</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}

{% tab title="400" %}

```json
[
"https://cdn.ttapi.io/other/2026-03-13/0157df8d-5687-4639-af9e-07ee23d00594.png",
"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"
]
```

{% endtab %}
{% endtabs %}

## 查询任务结果

<mark style="color:green;">`GET`</mark> `https://api.ttapi.io/grok/fetch`

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

**Headers**

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

**Body**

<table><thead><tr><th width="178">参数</th><th width="108">类型</th><th width="116">是否必须</th><th>描述</th></tr></thead><tbody><tr><td><code>jobId</code></td><td>String</td><td>是</td><td>生成的视频的jobId</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "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
    }
}
```

{% endtab %}
{% endtabs %}

## 结果参数详解

<table><thead><tr><th width="189">参数</th><th>详解</th></tr></thead><tbody><tr><td>status</td><td>结果状态，<br>ON_QUEUE：执行中<br>SUCCESS：成功<br>FAILED：失败</td></tr><tr><td>message</td><td>成功失败信息</td></tr><tr><td>data.quota</td><td>实际消耗额度</td></tr></tbody></table>