# 知格科技 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)，示例中的密钥和素材地址均需自行替换。

## 快速入门

通过一个 Base URL，接入对话、图片与视频生成。对话和同步图片接口兼容 OpenAI SDK，几分钟即可完成第一次调用。

### 1. 创建 API Key

前往[控制台 · API 密钥](https://zhigekeji.com/console/api-keys)创建密钥，并将它保存在服务端环境变量中。以下 cURL 示例适用于 Bash / zsh：

```bash
export ZHIGE_API_KEY="sk-your-api-key"
```

### 2. 获取可用模型

Base URL 为 `https://zhigekeji.com/api/v1`。先查询模型列表，再选择对应能力的模型：

```bash
curl "https://zhigekeji.com/api/v1/models" \
  -H "Authorization: Bearer $ZHIGE_API_KEY"
```

模型列表的 `type` 区分 `text`、`image` 和 `video`。调用时将返回的 `name` 填入 `model`，示例中的模型名称需替换为当前账号实际可用的名称。

### 3. 发起第一次对话

```bash
curl "https://zhigekeji.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $ZHIGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Qwen3-27B",
    "messages": [
      {"role": "user", "content": "你好，请介绍一下自己"}
    ]
  }'
```

成功后从 `choices[0].message.content` 读取回答。需要流式输出时传入 `stream: true`，按 SSE 格式读取，收到 `data: [DONE]` 后结束。

### 继续构建

- [使用 Python / Node.js SDK](https://zhigekeji.com/docs#openai-sdk)
- [生成与编辑图片](https://zhigekeji.com/docs#openai-images)
- [提交异步视频任务](https://zhigekeji.com/docs#openai-video-async)
- [将 API 接入智能体](https://zhigekeji.com/docs#agent-integration)