> 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/jian-li-yu-guan-li-api-quan-zhang.md).

# 建立與管理 API 權杖

ApiSmart 使用 **API 權杖** 用於驗證來自您應用程式的請求。

每個 Token 都可以單獨管理，且可能有其自己的使用上限。

> 🔐 **安全警告：** 任何擁有有效 API Token 存取權的人都可能發出請求並消耗您的錢包餘額。請妥善保管每個 Token。

***

### 🔑 開啟 API Token 管理

若要管理您的 API 金鑰：

1. 登入 ApiSmart。
2. 開啟 **主控台** 在左側導覽列中。
3. 選擇 **API 權杖**.

<figure><img src="/files/bb1c76fb190536cb27439a9c2be2370adae990bd" alt=""><figcaption></figcaption></figure>

此頁面顯示 API 請求所需的整合資訊：

```
API Base URL：https://gw.apismart.ai/v1
驗證：Authorization: Bearer
```

它也會顯示您現有的 **API 權杖**、使用上限、狀態、建立時間，以及可用操作。

***

### 建立 API Token

若要建立新的金鑰：

1. 開啟 **主控台 → API 權杖**.
2. 選擇 **建立 API 金鑰**.
3. 輸入 Token 名稱。
4. 啟用 **設定用量限制** （如有需要）。
5. 輸入此金鑰可消耗的最大金額。
6. 選擇 **確認**.

<figure><img src="/files/a595313d3203694d7250e61ed196296c478b8200" alt=""><figcaption></figcaption></figure>

7. 複製並安全地儲存新的金鑰。

#### 選擇清楚的 Token 名稱

使用能識別該 Token 會在哪裡使用的名稱。

範例：

```
開發正式環境圖片生成
```

若有多個專案，請考慮：

```
專案-環境-用途
```

範例：

```
客服-正式環境-聊天
```

***

### 💰 設定使用上限

可選的使用上限可控制單一 API Token 可消耗多少。

例如：

```
錢包餘額： $49
API Token 上限：    $5
```

雖然帳戶有 $49 可用，但該 API 金鑰只能消耗 $5。

***

### 複製並儲存您的 API Token

建立後複製該金鑰，並將其儲存在安全的位置。

管理表格只會顯示 Token 的遮罩版本。

```
430442******
```

如有可用，請使用複製按鈕。

<figure><img src="/files/c596cead9db84d72f0e26ca86e272d7c66c5fe42" alt=""><figcaption></figcaption></figure>

#### 將金鑰儲存在環境變數中

**macOS 或 Linux**

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

**Windows PowerShell**

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

請勿將正式環境金鑰直接儲存在原始碼中。

***

### 使用您的 API Token

ApiSmart 使用 Bearer 驗證。

在請求標頭中加入該金鑰：

```http
Authorization: Bearer YOUR_API_KEY
```

#### 使用 cURL 測試金鑰

```bash
curl https://gw.apismart.ai/v1/models \
  -H "Authorization: Bearer $APISMART_API_KEY"
```

成功的請求應回傳 API 回應，而不是驗證錯誤。

#### 聊天完成範例

確認 Token 可正常運作後，請參閱 [**Chat Completions API**](/documentation/zh-tw/api-zhi-nan/liao-tian-wan-cheng-api.md), [**圖片生成 API**](/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md)，或 [**影片生成 API**](/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md) 以取得完整的請求範例。

***

### 了解 API Token 表格

此項 **API Token 管理** 表格顯示以下資訊：

<figure><img src="/files/865af07fc4aaefce77f3a9165d2c106d0f8da2ff" alt=""><figcaption></figcaption></figure>

| 欄位           | 說明               |
| ------------ | ---------------- |
| **名稱**       | 建立時指定的 Token 名稱  |
| **金鑰**       | 遮罩後的 API Token 值 |
| **已使用 / 剩餘** | 在使用上限下已消耗與剩餘的額度  |
| **建立於**      | Token 建立的日期與時間   |
| **狀態**       | 此 Token 目前是啟用或停用 |
| **程式碼整合**    | 可直接複製的驗證範例       |
| **操作**       | 編輯、停用或刪除 Token   |

***

### 編輯 API Token

選擇 **編輯** 旁邊的 Token，以更新其可用設定。

<figure><img src="/files/862c9b51f90d79f37ae6612d3a6814f0c7a4b9d5" alt=""><figcaption></figcaption></figure>

根據目前的儀表板選項，您可能可以變更：

* Token 名稱
* 使用上限

變更 Token 名稱不會改變實際的 Token 值。

更新使用上限後，請查看 **已使用 / 剩餘** 以確認新的額度。

***

### 停用或刪除 API Token

使用 **停用** 當某個 Token 不應再被允許發出請求時。

使用 **刪除** 當 Token 不再需要時。

<figure><img src="/files/265c7d2fc96266638cb7a9d8fce22a16a6b122b4" alt=""><figcaption></figcaption></figure>

在變更應用程式使用的 Token 之前，請確認應用程式已更新為使用正確的替代 Token。

***

#### 🔐 API Token 安全性

* 請將 API Tokens 保持私密。
* 將 Tokens 儲存在環境變數或其他安全的伺服器端位置。
* 切勿在公開儲存庫或瀏覽器端程式碼中暴露 Tokens。
* 如果 Token 可能已外洩，請立即停用。
* 定期檢視 **使用紀錄** 中的不熟悉活動。

如需詳細的安全指引，請參閱 [**保護您的 API 金鑰**](/documentation/zh-tw/api-quan-zhang/bao-hu-nin-de-api-quan-zhang.md).

***

### 🛠️ 排解 API 金鑰問題

#### API Token 無法運作

請檢查：

* 已複製完整的 Token
* Token 狀態為 **已啟用**
* Token 仍有可用額度
* 您的錢包餘額充足
* API Base URL 正確
* 請求使用 Bearer 驗證

```
Authorization: Bearer YOUR_API_KEY
```

***

#### 帳戶有餘額，但請求仍然失敗

錢包餘額與 API Token 上限是彼此獨立的控制項。

檢查：

* **錢包 → 目前餘額**
* **API 權杖 → 已使用 / 剩餘**
* Token 狀態
* 模型 ID
* API 端點
* 請求格式

***

#### 我看到我不認得的使用量

* 停用受影響的 API 權杖。
* 建立替代權杖。
* 更新您的應用程式。
* 定期檢視 **主控台 → 使用記錄**.
* 儲存不熟悉的請求 ID，如有需要請聯絡支援。

> 🔐 絕不要向支援提供你的完整 API Token。

***

### 🚀 下一步

繼續進行：

* [**API 基礎**](/documentation/zh-tw/api-zhi-nan/api-ji-chu.md)
* [**查看您的餘額與交易紀錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md)
* [**選擇模型並尋找其模型 ID**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-yu-mo-xing-id.md)
* [**快速入門**](/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-ru-men.md)
* [**使用紀錄與成本**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)