> For the complete documentation index, see [llms.txt](https://docs.apismart.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apismart.ai/documentation/zh-tw/api-quan-zhang/bao-hu-nin-de-api-quan-zhang.md).

# 保護您的 API 權杖

ApiSmart 使用 **API 權杖** 用於驗證 API 請求。透過這些權杖產生的用量可能會從您的錢包餘額中扣除。

任何能存取有效 API 權杖的人，都可能發出 API 請求並消耗您的錢包餘額。請遵循以下做法，確保您的權杖安全。

***

### 🔐 安全儲存 API 權杖

將 API 權杖儲存在環境變數或其他受信任的伺服器端密鑰儲存系統中。

#### macOS 或 Linux

```bash
export APISMART_API_KEY="YOUR_API_KEY"
```

#### Windows PowerShell

```powershell
$env:APISMART_API_KEY="YOUR_API_KEY"
```

切勿將正式環境權杖提交到儲存在 Git 中的原始碼或設定檔。

***

### 絕不要公開暴露 API 權杖

請勿將 API 權杖包含在：

* 公開儲存庫
* 瀏覽器端或用戶端程式碼
* 螢幕截圖或螢幕錄影
* 共享文件或公開支援訊息
* 應用程式記錄

聯絡支援時，如有需要，僅提供遮蔽後的權杖或短前綴。

***

### 在伺服器端使用 API 權杖

請勿使用您的 API 權杖從公開的瀏覽器應用程式直接呼叫 ApiSmart。

將權杖儲存在您的後端伺服器，並由該處發送 API 請求。

```
使用者應用程式
      ↓
您的後端伺服器
      ↓
ApiSmart API 權杖
      ↓
ApiSmart API
```

您的後端應妥善儲存金鑰，並控制可發送哪些請求。

***

### 設定用量限制

建立 API 權杖時，請啟用 **設定用量限制** （如適用）。

用量限制可在權杖設定錯誤或遭外洩時，協助控制其可消耗的最大量。

> 用量限制可降低潛在影響，但無法取代妥善的權杖保護。

***

### 使用不同的 API 權杖

為不同的環境或應用程式建立獨立的權杖。

例如：

```
開發生產圖片生成影片生成
```

使用獨立權杖可更容易：

* 追蹤用量
* 控制支出
* 停用某個應用程式而不影響其他應用程式
* 調查不熟悉的請求

***

### 停用未使用的 API 權杖

定期檢視 **主控台 → API 權杖** ，並停用不再需要的權杖。

在刪除權杖前，請確認沒有任何運作中的應用程式或排程工作仍依賴它。

***

### 🔄更換已曝光的 API 權杖

如果權杖出現在公開程式碼、螢幕截圖、前端程式碼、記錄或其他不受信任的位置：

1. 立即停用已曝光的權杖。
2. 建立替代權杖。
3. 更新您的應用程式或環境變數。
4. 測試替代權杖。
5. 檢視 **使用記錄** 中的不熟悉活動。

當舊權杖不再需要時，將其刪除。

> 建立替代權杖不會自動停用已曝光的那一個。

***

### 定期監控用量

檢視 **使用記錄**, **目前餘額**，以及 **總消耗量** ：

* 意外的請求
* 不熟悉的模型或權杖活動
* 用量或費用突然增加

如果您發現可疑活動：

1. 停用受影響的 API 權杖。
2. 如有需要，建立替代權杖。
3. 檢視最近的使用記錄。
4. 儲存相關的請求 ID。
5. 必要時聯絡支援。

> ⚠️ 絕不要將您的完整 API 權杖、帳號密碼或驗證碼傳送給支援。

***

### 下一步

繼續進行：

* [**建立與管理 API 權杖**](/documentation/zh-tw/api-quan-zhang/jian-li-yu-guan-li-api-quan-zhang.md)
* [**使用記錄與費用**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)
* [**查看您的餘額與交易記錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md)
* [**API 基礎**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md)