管理
列出 API Keys
列出目前管理令牌所屬組織下的使用者 API Key。
GEThttps://api.tokenlab.sh/v1/management/api-keys
概覽
返回目前管理令牌所屬組織下的使用者 API Key 清單。
注意事項
-
金額欄位僅支援 USD。
-
系統代管的 Key 不會出現在結果中。
範例
pageintegerquery預設值:
1從 1 開始的頁碼。
limitintegerquery預設值:
50每頁筆數，範圍為 1–100。
請求
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token"請求 / 回應
本頁提供 OpenAPI 結構說明及可複製的請求範例。請在終端機或用戶端使用 Management Token 傳送管理請求；本頁不提供直接傳送功能。
回應
{
"object": "list",
"data": [
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-3-7-sonnet"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
}
],
"pagination": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1
}
}重要欄位
objectstring
固定為
list。dataarray
API Key 物件陣列。
paginationobject
分頁中繼資料，包含
page、limit、total 和 totalPages。data[].idstring
用於後續管理 API 呼叫的 API Key 識別碼。
data[].namestring
API Key 的顯示名稱。
data[].key_prefixstring
用於顯示和支援排查的非敏感 Key 前綴。
data[].statusstring
值為
active、inactive、suspended 或 revoked。data[].limit_amountnumber | null
以 JSON 數字回傳的 USD 消費上限，供顯示使用。
null 表示不設限。data[].limit_amount_decimalstring | null
以十進位字串回傳的 USD 精確消費上限。
null 表示不設限。data[].used_amountnumber
以 JSON 數字回傳的 USD 累計用量支出，供顯示使用。
data[].used_amount_decimalstring
以十進位字串回傳的 USD 精確累計用量支出。
data[].modelsstring[]
單一 Key 的模型白名單。空陣列表示沒有額外的 Key 層級模型限制。
data[].delivery_policystring | null
auto, verified, official, null. null 表示繼承工作區交付策略。data[].expires_atstring | null
Key 到期時間的 ISO 時間戳記；
null 表示永不到期。data[].last_used_atstring | null
最近一次使用的 ISO 時間戳記；從未使用時為
null。data[].created_atstring
建立時間的 ISO 時間戳記。
授權
ManagementTokenAuth AuthorizationBearer <token>
管理權杖驗證。請在 Dashboard > API > Management Tokens 建立或管理管理權杖。
位置: header
回應
application/json
application/json
application/json