Management API Keys
Management API Key 用於管理團隊的所有專案、預算與模型 API Key,並查詢專案及 Key 用量。
Management API Key 用於管理團隊的所有專案、預算與模型 API Key,並查詢專案及 Key 用量。
各介面使用哪種 Key?
此表僅比較兩種 API Key;已啟用的 OAuth scoped token 仍可依原規則查詢計費資料。
建立管理 Key
- 登入控制台,切換至你擔任 Owner 的團隊帳戶。
- 從側欄 Developer(開發者) → Management API Keys 開啟管理頁,或直接前往。此入口僅對目前的團隊 Owner 顯示。
- 填寫 Name,視需要設定 Expires (optional),按下 Create key。
- 按下 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