# 认证与 API Key

创建、使用、限制、更换和保管 API Key。

> https://docs.kovapi.com/zh/guide/api-keys

## 创建 API Key

1. 登录后打开控制台「API Keys」页面，给 Key 起一个能认出用途的名字。

2. 按需要设置限制（每分钟请求数、预算、白名单），也可以以后再改。

3. 创建后，Key 出现在列表里，点「复制」拿到完整的 Key（以 `sk-` 开头），保存到安全的地方，例如服务器的环境变量。

## 在请求里带上 Key

OpenAI 兼容接口用 `Authorization: Bearer` 请求头；Anthropic 接口用 `x-api-key`，也接受 `Authorization: Bearer`。建议把 Key 放在环境变量里，不要写进代码。

```
Authorization: Bearer YOUR_API_KEY
```

```
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
```

```
import os
from openai import OpenAI

# export KOVAPI_API_KEY=sk-...   (never commit the key)
client = OpenAI(base_url="https://kovapi.com/v1", api_key=os.environ["KOVAPI_API_KEY"])
```

## 给 Key 加限制

每把 Key 都可以单独设置下面这些限制，互不影响：

| 设置 | 作用 |
| --- | --- |
| **每分钟请求数** | 这把 Key 每分钟最多发多少个请求。 |
| **每日预算** | 这把 Key 每天（UTC）最多花多少美元。 |
| **总额度** | 这把 Key 一共最多花多少美元，适合交给自动化任务、防止跑飞。 |
| **模型白名单** | 这把 Key 只能调用列出的模型。 |
| **IP 白名单** | 只接受来自列出的 IP 或网段的请求。 |

[超出限制时返回什么 →](https://docs.kovapi.com/zh/guide/rate-limits#per-key)

## 停用与更换

1. 先新建一把 Key，把用到的地方换成新的。

2. 确认新 Key 在正常调用后，在控制台停用旧 Key；停用立即生效，之后旧 Key 的请求返回 401。

3. 怀疑 Key 泄露时，先停用，再新建。

## 安全建议

- Key 只放在服务端；不要写进网页、App 或公开的代码仓库。

- 每个应用、每个环境用一把单独的 Key，出问题时只停那一把。

- 给自动化任务和第三方工具用的 Key 设上预算或总额度。

- 服务器 IP 固定时，打开 IP 白名单。

## 余额属于账户

同一个账户下的所有 Key 共用一个余额。用任意一把 Key 调用 `GET /v1/usage` 都能查到账户余额和消费。
