> 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/yi-nan-pai-jie/api-jin-yue-yu-yan-zheng-wen-ti.md).

# API 金鑰與驗證問題

排解 ApiSmart API 金鑰驗證錯誤、無效憑證、模型存取問題以及常見的授權問題。

ApiSmart 使用 API 金鑰來驗證 API 請求。

如果請求回傳 `401` 或 `403`，請在重試前檢查你的 API 金鑰、授權標頭和模型存取權。

### 🔑 檢查你的授權標頭

在每個經過驗證的請求中都包含你的 API 金鑰：

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

範例：

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

請確保：

* `Bearer` 已包含
* 在以下之間有一個空格 `Bearer` 與 API 金鑰之間
* API 金鑰是完整的
* 沒有將多餘的引號或空格複製進金鑰中

### 401 — 無效的 API 金鑰

如果 API 回傳：

```
401 invalid_api_key
```

API 金鑰無法通過驗證。

請確認你使用的是正確的 API 金鑰，且你的應用程式正在將它送入 `Authorization` 標頭。

必要時，請從 ApiSmart Console 建立或管理你的憑證。

關於 API 金鑰管理，請參閱 [**建立與管理 API 金鑰**](https://docs.apismart.ai/documentation/zh-tw/huan-ying-shi-yong-apismart/api-jin-yue/jian-li-bing-guan-li-api-jin-yue.md).

### 403 — 模型存取問題

一個 `403` 回應並不一定代表你的 API 金鑰本身無效。

例如：

```
403 model_not_allowed
```

表示 API 金鑰已通過驗證，但所選模型目前無法供你的帳戶使用。

其他與模型相關的 `403` 錯誤可能包括：

* `model_not_image_capable` — 該模型無法與圖片生成 API 搭配使用
* `model_not_video_capable` — 該模型無法與影片生成 API 搭配使用
* `AccessDenied` — 對所請求的模型或操作的存取被拒絕

請選擇受支援的模型，或聯絡 [**ApiSmart 支援**](https://docs.apismart.ai/documentation/zh-tw/shuo-ming-yu-zi-yuan/lian-luo-zhi-yuan.md) 如果你需要存取權。

### 🧩 驗證模型 ID

你可以使用以下方式擷取目前的模型清單：

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

使用傳回的 `data[].id` 值，請完全依照原樣使用。

模型 ID 會以完全相符的方式比對，包括句點、連字號與版本號。寫錯的模型 ID 可能會導致意外的 `503`，因此在假設問題與驗證相關之前，請仔細檢查模型 ID。

### 🔒 請妥善保護你的 API 金鑰

不要：

* 在前端程式碼中暴露 API 金鑰
* 將 API 金鑰提交到公開儲存庫
* 在截圖或記錄中包含完整的 API 金鑰
* 將你的完整 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 金鑰正確
* 標頭使用 `Authorization: Bearer <your-api-key>`
* 請求的模型 ID 正確
* 該模型可供你的 API 金鑰使用
* 所選模型支援該 API 端點

關於其他錯誤，請參閱 [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md).

### ➡️ 下一步

* [**建立與管理 API 金鑰**](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 金鑰**](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)
* [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md)
