# 知格科技 API 文档

通过统一的 API 接入对话、图片与视频生成，可用于应用开发及智能体工具对接。

- 文档地址：[API 文档](https://zhigekeji.com/docs)
- Base URL：`https://zhigekeji.com/api/v1`
- 认证方式：`Authorization: Bearer <API_KEY>`
- JSON 请求使用 `Content-Type: application/json`
- 在[控制台创建 API Key](https://zhigekeji.com/console/api-keys)，示例中的密钥和素材地址均需自行替换。

## 视频任务列表

查询当前用户的视频生成任务列表，支持按状态筛选。

```http
GET https://zhigekeji.com/api/v1/videos/generations/list?status=completed&limit=20&page=1
Authorization: Bearer sk-xxxx...
```

### 查询参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `status` | string | 否 | 按数据库状态筛选：`pending` / `running` / `completed` / `failed` / `cancelled` |
| `limit` | integer | 否 | 每页数量，默认 20，最大 100 |
| `page` | integer | 否 | 页码，默认 1 |

返回示例：

```json
{
  "object": "list",
  "data": [
    {
      "task_id": "6601",
      "status": "completed",
      "model": "workflow-12",
      "model_name": "minimax-h3-turbo-frames",
      "created_at": "2026-08-13T10:00:00Z",
      "completed_at": "2026-08-13T10:05:30Z"
    }
  ],
  "pagination": {
    "total": 1,
    "per_page": 20,
    "current_page": 1,
    "last_page": 1
  }
}
```

任务列表不返回生成结果；请使用视频状态查询接口读取完成任务的 `data`。