> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API 密钥

> 在仪表盘中创建和管理 API 密钥。

在仪表盘侧边栏中导航到 **API Keys** 来管理你的密钥。

## 创建密钥

1. 点击 **Create Key**
2. 输入一个名称（例如 "Production"、"Development"）
3. 可选地设置 **scopes（作用域）** 以限制该密钥可访问的内容（例如仅限补全）
4. 可选地为该密钥设置 **rate limits（速率限制）** 和 **spending caps（消费上限）**
5. 复制密钥——**该密钥不会再次显示**

<Warning>
  请妥善保管 API 密钥。使用环境变量或密钥管理工具存储。切勿将密钥提交到源代码仓库。
</Warning>

## 密钥格式

| Prefix | Environment | Billing |
| - | - | - |
| `theo_sk_live_` | 生产环境 | 按令牌计费 |
| `theo_sk_test_` | 沙盒环境 | 不计费，速率限制更低 |

## 密钥管理

* **Revoke（撤销）**——立即禁用某个密钥（数秒内生效）
* **Rename（重命名）**——更新显示名称
* **View usage（查看用量）**——查看按密钥统计的用量、费用和请求次数
* **Edit limits（编辑限制）**——调整每个密钥的速率限制和消费上限

## 密钥轮换

在不中断服务的情况下轮换密钥：

1. 创建一个新密钥
2. 更新你的环境变量
3. 确认流量已切换到新密钥
4. 撤销旧密钥

在过渡期间，新旧两个密钥可以同时正常使用。

## 以编程方式管理密钥

你也可以通过 API 创建密钥：[Create API Key](/api-reference/keys/create)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.