建立 API 金鑰
在控制台「API 金鑰」建立金鑰，可設定消費上限與過期時間；金鑰只在建立時完整顯示一次。
呼叫 API 之前需要先有 API 金鑰。金鑰在控制台的「API 金鑰」頁建立與管理；一個帳戶可以持有多把金鑰，用於不同用途。
如何建立金鑰
- 登入並開啟控制台，在左側導覽選擇 API 金鑰。
- 點選「建立金鑰」並填寫：
| 欄位 | 必填 | 說明 |
|---|---|---|
| 名稱 | 是 | 依用途命名以便辨識，例如 production、test。 |
| 消費上限（美元） | 否 | 該金鑰的累計消費上限。留空表示不限。 |
| 過期日期 | 否 | 超過此日期後金鑰會自動失效。留空表示不過期。 |
- 提交建立。彈窗會只顯示一次完整金鑰——請立刻複製並妥善保存。
金鑰的顯示方式
- 完整金鑰只在建立時顯示一次。關閉彈窗後就無法再次檢視。
- 金鑰清單一律顯示遮罩形式（前綴與末 4 碼），以避免被旁人窺視。
- 金鑰遺失了？刪除它並建立新的即可——新金鑰立即生效。
安全建議
- 切勿把金鑰放進前端程式碼、公開儲存庫或聊天訊息——持有金鑰的人都能花用你的餘額。
- 依環境拆分金鑰（一把正式、一把測試），並為正式金鑰設定消費上限，把影響範圍控制在有限區間。
- 若懷疑金鑰外洩，請立即刪除並建立新的。刪除會立刻生效——用舊金鑰的呼叫會收到 401。
- 要給他人臨時存取權時，請另外建立一把額度較小的金鑰，用完後刪除，而不是把你的主要金鑰分享出去。