管理、重新產生與撤銷 API 權杖
尋找您的 API 權杖、重新產生密鑰（僅限一次，可選擇 24 小時的重疊期）、撤銷權杖、了解到期日與 IP 允許清單，並查看權杖停止運作的原因。
權杖分頁列出了您的 API 權杖及其存取權限、限制與最後使用時間。您可以在此重新產生權杖的密鑰、撤銷權杖，並查看權杖停止運作的原因。
如何找到您的權杖
開啟工作區選單並選擇 AI agents & API。權杖分頁是第一個分頁；每個分頁都會顯示其數量。
誰可以看到哪些權杖：
| 您的角色 | 您可以看到 | 您可以執行 |
|---|---|---|
| 擁有者或管理員 | 「此工作區中的每一個權杖。成員只能看到自己的。」使用擁有者選單依人員篩選（所有人顯示全部）。 | 撤銷任何權杖。僅能重新產生您自己的權杖。 |
| 編輯者或內容創作者 | 「您的權杖。使用這些權杖的代理程式將以您的身分執行。」 | 撤銷並重新產生您自己的權杖。 |
每一列顯示名稱（包含密鑰的最後幾個字元，例如 clv_agent_…k7Qe）、擁有者、存取權限（其權限）、涵蓋的網站、已建立、最後使用與到期日。頁尾會計算工作區中已使用的權杖數量是否達到限制。列上的徽章說明：
| 徽章 | 含義 |
|---|---|
| 消耗點數 | 該權杖具有 credits:spend。指向它可查看其上限：每日、每月、每個任務（空白時表示「無上限」）以及「低於 n 點數時自動核准」或「由人員核准每次付費啟動」。 |
| IP 受限 | 該權杖設有 IP 允許清單，且僅能從這些位址運作。 |
| 超出角色權限 | 「擁有者的角色已變更。需要被刪除權限的呼叫將被拒絕。」 |
| 已撤銷 / 已過期 | 該權杖已無法運作。原因顯示在旁邊（請參閱 為什麼權杖停止運作）。 |
已撤銷與已過期的權杖預設為隱藏。點擊顯示已撤銷與已過期的權杖 (count) 即可列出它們；它們會保留在清單中 30 天。
變更權杖的存取權限
權杖的權限、網站、到期日、點數上限與 IP 允許清單在建立後無法編輯。若要變更其中任何一項，請建立一個新權杖並設定新的選項，將您的代理程式切換過去，然後撤銷舊的權杖。
重新產生權杖的密鑰
當密鑰可能外洩時，或為了按排程輪替密鑰，請進行重新產生。新的密鑰具有相同的名稱、存取權限、網站、IP 允許清單、點數上限與到期日。
開啟權杖選單
在權杖分頁上，開啟權杖列上的 ⋯ 選單並選擇 重新產生密鑰。
選擇舊密鑰何時停止運作
對話框會詢問「重新產生“name”嗎？」：「您將獲得一個具有相同存取權限的新密鑰。舊的密鑰將停止運作。」如果代理程式仍在使用該權杖且您需要時間進行切換，請勾選保持舊密鑰運作 24 小時。若要立即停止舊密鑰，請勿勾選此項。
複製新密鑰
點擊重新產生。權杖已建立對話框會顯示新密鑰一次。請複製它，更新您的代理程式或密鑰儲存庫，然後點擊我已儲存它。
重新產生的規則：
- 只有建立權杖的人員可以重新產生它。 非建立者的擁有者或管理員會看到「只有建立此權杖的人員可以重新產生它。您可以撤銷它。」
- 密鑰只能重新產生一次。 之後，舊的列會顯示「已被重新產生的密鑰取代」且沒有重新產生密鑰選項；請改為重新產生新的權杖。對舊密鑰再次嘗試會顯示「此權杖已被重新產生、撤銷或已過期；請使用其替代品或建立一個新權杖。」
- 到期日不會變動。 為 90 天建立的權杖仍會在原始日期到期。如果舊密鑰的 24 小時重疊期超過該日期，它會在到期日停止運作。
- 即使工作區達到使用中權杖限制，您仍可進行重新產生。在 24 小時的重疊期間，兩個密鑰皆可運作，且兩者皆計入使用中權杖數量。
- 重新產生需要工作區方案為 Pro 或以上；否則重新產生密鑰會開啟升級對話框。
撤銷權杖
- 開啟權杖列上的 ⋯ 選單並選擇 撤銷。
- 使用撤銷權杖進行確認：「使用此權杖的代理程式將立即失去存取權限。此動作無法復原。」
撤銷後的權杖會立即釋放其在工作區使用中權杖限制中的名額。
到期日
每個權杖都會過期。您在建立時選擇其有效期：7 天、30 天、90 天（預設）或 1 年。沒有「永不過期」的選項，因此被遺忘的權杖無法永久有效。到期日欄位會顯示該日期。
超過到期日後，每次呼叫都會回傳「此權杖已過期。請在 Integrations → AI agents & API 中建立一個新權杖。」已過期的權杖無法續期或重新產生；請建立一個新權杖。
IP 允許清單
權杖可以限制為僅能從您的代理程式執行的位址（例如 CI 執行器或伺服器）使用。您可以在精靈的限制步驟中，於進階 → IP 允許清單下進行設定：「選填。每行輸入一個位址或範圍；來自其他任何地方的呼叫將被拒絕。」
- 輸入 IPv4 或 IPv6 位址 (
203.0.113.7) 或 CIDR 格式的範圍 (198.51.100.0/24)，最多 20 筆。 - 保持空白以允許任何位址。審查步驟將顯示任何網址。
- 來自其他位址的呼叫會回傳「此權杖無法從此 IP 位址使用。」
- 非位址或範圍的輸入將被拒絕：「value 不是 IP 位址或範圍。」
為什麼權杖停止運作
| 權杖顯示內容 | 發生什麼事 | 該怎麼做 |
|---|---|---|
| 已過期 | 有效期已過。 | 建立一個新權杖。 |
| 「由擁有者撤銷」 | 建立該權杖的人員已撤銷它。 | 若仍需要，請建立一個新權杖。 |
| 「由管理員撤銷」 | 工作區擁有者或管理員已撤銷它。 | 在建立新權杖前，先詢問他們原因。 |
| 「已撤銷：擁有者已離開工作區」 | 建立該權杖的人員已從工作區移除。他們所有的權杖皆被撤銷。 | 由工作區內的其他人員建立一個新權杖。 |
| 「已撤銷：擁有者帳號已刪除」 | 擁有者已刪除其 Clevera 帳號。 | 建立一個新權杖。 |
| 「已被重新產生的密鑰取代」 | 密鑰已重新產生。 | 使用新密鑰。 |
| 「已撤銷：在公開儲存庫中發現」 | 該權杖在公開的 GitHub 儲存庫中被發現並自動撤銷。 | 從儲存庫歷史記錄中移除它，然後建立一個新權杖並存放在密鑰儲存庫中。 |
| 「已撤銷：異常活動」 | 它在幾分鐘內發出了許多被拒絕的請求（10 分鐘內超過 50 次）。 | 檢查活動以了解其嘗試內容，修復代理程式，然後建立一個新權杖。 |
| 「已撤銷：偵測到權杖重複使用」 / 「已撤銷：應用程式已中斷連線」 | 這些適用於已連線的應用程式，而非 API 權杖。 | 重新連線該應用程式。 |
| 每次呼叫回傳「代理程式 API 不在此工作區的方案中。它適用於 Pro 及以上方案。」 | 工作區已移出 Pro、Business 或 Custom 方案。 | 升級至 Pro。請參閱 如果工作區離開 Pro 方案。 |
異常活動
Clevera 會監控每個權杖的突發流量，並透過「token 發生異常活動」通知告知工作區擁有者：
- 許多被拒絕的請求：在幾分鐘內發生，權杖會被撤銷。「它在幾分鐘內發出了許多被拒絕的請求。」
- 異常大量的變更：在幾分鐘內發生（10 分鐘內超過 200 次寫入或 20 次頁面移除）：其寫入功能會暫停 10 分鐘。呼叫會回傳「此權杖的寫入功能在異常變更突發後已暫停。工作區擁有者已收到通知。」讀取功能仍可運作。
- 點數消耗異常快速：該權杖在 24 小時內無法啟動付費工作。「它在幾分鐘內消耗了異常大量的點數，因此目前無法啟動付費工作。」
如果工作區離開 Pro 方案
AI agents & API 包含在 Pro、Business 與 Custom 方案中。如果工作區移至 Starter 或 Free 方案，頁面會顯示「AI agents & API 包含在 Pro 方案中」：「升級以讓 Claude、ChatGPT 與您的指令碼在此工作區中運作。現有的權杖與應用程式將停止運作，直到升級為止；您仍可在此處撤銷它們。」
- 權杖會保留在清單中且可以撤銷，但每次呼叫都會被
plan_locked拒絕。 - 重新產生密鑰會改為開啟升級對話框。
- 升級回 Pro 方案後，權杖即可恢復運作。沒有任何內容會被刪除；權杖仍會在各自的日期到期。