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

## 图片生成

兼容 OpenAI `/v1/images/generations` 格式。既支持文生图，也支持部分模型使用参考图进行编辑；参考图数量和尺寸处理方式由所选模型决定。

### 请求参数

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `model` | string | 是 | 模型名，以 `GET /v1/models` 返回的 `name` 为准 |
| `prompt` | string | 是 | 图片描述提示词，最长 4000 字符 |
| `size` | string | 否 | 图片尺寸，如 `768x1344` |
| `response_format` | string | 否 | 返回格式：`url`（默认）或 `b64_json` |
| `images` | string[] | 否 | 参考图片数组，每项为 URL 或 data URI；数量上限由模型决定 |
| `prompt_mode` | string | 否 | `add`（默认，保留原提示词；有参考图时补充图片信息）或 `optimize`（结合参考图优化提示词） |

> 可用图片模型、参考图数量和支持尺寸可能由管理端调整，请以 `GET /v1/models` 返回结果及接口校验结果为准。

### 基础图片生成

```http
POST https://zhigekeji.com/api/v1/images/generations
Authorization: Bearer sk-xxxx...
Content-Type: application/json

{
  "model": "ernie-image",
  "prompt": "一个穿着棒球服的少女，树下",
  "size": "768x1344",
  "response_format": "url"
}
```

### 带参考图的图片生成

部分图片模型支持参考图，图片顺序即参考顺序；具体数量限制以所选模型为准：

```http
POST https://zhigekeji.com/api/v1/images/generations
Authorization: Bearer sk-xxxx...
Content-Type: application/json

{
  "model": "ernie-image",
  "prompt": "保留人物五官和发型，将背景改为明亮的城市咖啡馆",
  "images": [
    "https://example.com/reference.jpg"
  ],
  "size": "768x1344"
}
```

返回示例：

```json
{
  "created": 1716652800,
  "data": [
    {
      "url": "http://host/view?filename=00001_.png"
    }
  ]
}
```