> ## 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.