> 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/huan-ying-shi-yong-apismart/api-jin-yue/jian-li-bing-guan-li-api-jin-yue.md).

# 建立並管理 API 金鑰

了解如何建立、使用、編輯、停用與刪除 ApiSmart API 金鑰，以進行安全的 API 驗證。

API 金鑰是用於驗證對 ApiSmart API 發出請求的憑證。

您可以在 ApiSmart 控制台中建立及管理 API 金鑰。每個金鑰都可用於存取您的帳戶可使用的支援 API 端點和模型。

### 🔑 建立 API 金鑰

登入 ApiSmart 控制台，然後前往：

**控制台 → API 金鑰**

按一下 **建立 API 金鑰** 以建立新的憑證。

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2F2twZekDMOGW3VV6iu4nP%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_182828.png?alt=media&amp;token=99990ad2-f83e-4d79-bd55-e54ff7c52c90" alt=""><figcaption></figcaption></figure>

建立金鑰時，請使用可協助您辨識其使用位置的描述性名稱。

例如：

* 開發環境
* 正式環境
* 後端服務
* 內部測試

針對不同應用程式或環境使用不同的 API 金鑰，可讓日後管理更加容易。

建立金鑰後，請妥善安全儲存，並僅在受信任的應用程式中使用。

### 🔗 使用您的 API 金鑰

標準 ApiSmart API 基礎 URL 為：

`https://gw.apismart.ai/v1`

請在請求的 `Authorization` 標頭中包含您的 API 金鑰，以驗證請求：

```http
Authorization: Bearer <your-api-key>
```

將 `<your-api-key>` 替換為您的實際 API 金鑰。

例如，您可以透過請求可用模型清單來測試您的金鑰：

```bash
curl https://gw.apismart.ai/v1/models \
  -H "Authorization: Bearer <your-api-key>"
```

如果驗證成功，API 會傳回目前可透過平台使用的模型。

### 🗂️ 管理現有 API 金鑰

「 **API 金鑰** 」頁面會列出您已建立的憑證。

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2FRIMHInCOBW3JUvkGAkdw%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_183023.png?alt=media&amp;token=7058c5df-b81c-449b-980d-f24d5bea212d" alt=""><figcaption></figcaption></figure>

您可以針對每個金鑰查看以下資訊：

* 金鑰名稱
* 金鑰識別碼
* 使用量或剩餘餘額資訊
* 建立時間
* 目前狀態
* 整合範例

您也可以依名稱或前綴搜尋現有金鑰。

### ✏️ 編輯 API 金鑰

使用 **編輯** ，在您需要更新現有 API 金鑰相關資訊時。

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2FhM3rYACsjwnVHUWgffem%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_183241.png?alt=media&amp;token=bbd9ff3b-532c-4c9a-8f24-394ed1d1a967" alt=""><figcaption></figcaption></figure>

例如，您可能想重新命名金鑰，以便更容易辨識其用途。

請使用清楚的名稱，例如：

`正式環境後端`

或：

`開發測試`

當您的帳戶包含多個 API 金鑰時，這會特別實用。

### ⏸️ 停用 API 金鑰

如果您想暫時阻止某個金鑰發出 API 請求，請選取 **停用**.

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2F2zntNiTqetWsxSBLi2Vc%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_183746.png?alt=media&amp;token=8943ee79-bc56-402d-b21c-5340c0c12be9" alt=""><figcaption></figcaption></figure>

已停用的金鑰將無法再用於驗證 API 請求。

在以下情況停用金鑰很有用：

* 某個應用程式暫時未啟用
* 您正在調查非預期的使用情況
* 您想停止存取權，而不立即刪除金鑰

若日後再次需要該金鑰，當選項可用時，您可以在控制台中重新啟用它。

### 🗑️ 刪除 API 金鑰

使用 **刪除** ，當不再需要 API 金鑰時。

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2FBUTGkF00OygD8HiunM0n%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_183809.png?alt=media&amp;token=49d37915-5b2a-424a-aee7-42b4bc2e53b8" alt=""><figcaption></figcaption></figure>

請刪除屬於不再使用的應用程式、環境或服務的金鑰。

刪除金鑰前，請確認沒有仍在運作的應用程式依賴它。使用已刪除金鑰的請求將無法再成功驗證。

### ⚠️ 確保 API 金鑰安全

API 金鑰可存取您的 ApiSmart 帳戶，應視為敏感憑證處理。

請勿：

* 公開分享 API 金鑰
* 將 API 金鑰提交至公開的 Git 儲存庫
* 將 API 金鑰直接包含在可公開存取的用戶端程式碼中
* 在螢幕截圖、日誌或支援請求中傳送完整 API 金鑰

如需詳細的安全建議，請參閱 [**保護您的 API 金鑰**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/bao-hu-nin-de-api-jin-yue.md).

### 🛠️ 驗證問題

如果 API 傳回：

`401 invalid_api_key`

請檢查以下項目：

1. API 金鑰已正確複製
2. 該金鑰目前已啟用
3. 請求使用 `Bearer` 驗證機制
4. 「 `Authorization` 標頭的格式正確
5. 沒有遺漏字元或多餘空格

預期格式為：

```http
Authorization: Bearer <your-api-key>
```

如果金鑰有效，但特定模型傳回：

`403 model_not_allowed`

表示該模型目前未針對該 API 金鑰或帳戶啟用。

請參閱 [**模型與模型 ID**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md) 以取得更多關於模型存取權的資訊。

### ➡️ 後續步驟

建立 API 金鑰後，請繼續進行：

* [**保護您的 API 金鑰**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/bao-hu-nin-de-api-jin-yue.md) — 了解建議的安全性做法
* [**模型與模型 ID**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-yu-mo-xing-id.md) — 尋找可透過 API 使用的模型
* [**快速入門**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/kuai-su-kai-shi.md) — 發送您的第一個 API 請求
* [**API 基礎知識**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/api-ji-chu.md) — 了解常見的 API 慣例
* [**聊天完成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/liao-tian-bu-quan-api.md) — 開始使用文字模型進行建置
* [**影像生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md) — 生成及編輯影像
* [**影片生成 API** ](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)— 建立影片生成工作流程
