Management API Keys

Management API Key 用於管理團隊的所有專案、預算與模型 API Key,並查詢專案及 Key 用量。

Management API Key 用於管理團隊的所有專案、預算與模型 API Key,並查詢專案及 Key 用量。

各介面使用哪種 Key?

此表僅比較兩種 API Key;已啟用的 OAuth scoped token 仍可依原規則查詢計費資料。

建立管理 Key

  1. 登入控制台,切換至你擔任 Owner 的團隊帳戶。
  2. 從側欄 Developer(開發者) → Management API Keys 開啟管理頁,或直接前往。此入口僅對目前的團隊 Owner 顯示。
  3. 填寫 Name,視需要設定 Expires (optional),按下 Create key。
  4. 按下 Copy key,儲存新的 mgmt-...,並在範例中設為 ATLASCLOUD_MANAGEMENT_API_KEY。明文僅顯示一次。

api_key_id 從哪裡取得?

URL 中的 api_key_id 就是建立模型 API Key(POST /public/v1/api-keys)回應中的 id,格式為 ak_...。 請儲存此值,以便停用、刪除、設定額度及查詢用量。回應中的 key(apikey-...)用於模型呼叫;管理操作的驗證標頭仍使用 mgmt-...。

例如,建立回應包含下列欄位:

{
  "id": "ak_0123456789ABCDEFGHIJKL",
  "key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}

將相同的 id 填入路徑,例如 /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage。範例中的 API_KEY_ID 也代表此值。目前 Public API 沒有 Key 列表介面,請在建立時儲存 id。

呼叫 Public API

在 Authorization: Bearer 標頭中傳入管理 Key。請求使用該 Key 所屬的團隊帳戶。

curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
  -H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-123"}'

逐步開通指南(英文).

管理 Key 的生命週期

停用、刪除或過期的管理 Key 無法驗證。可在管理頁啟用或停用尚未過期的 Key;刪除無法復原。

管理 Key 屬於團隊,建立者離開團隊或不再擔任 Owner 時仍然有效。目前的 Owner 可管理前任 Owner 建立的 Key。如需撤銷存取權,請停用或刪除對應 Key。

每個團隊最多保留 5 個未刪除的管理 Key,包含已停用及已過期的 Key;刪除後會釋出名額。

Last updated on

On this page