TokenLab

管理

列出 API Keys

列出當前組織管理 token 下由使用者管理的 API keys。

GEThttps://api.tokenlab.sh/v1/management/api-keys

概覽

返回與當前管理 token 關聯的組織中的使用者 API keys。

注意事項

  • 金額欄位僅以 USD 為單位。

  • 不包含系統管理的 keys。

範例

pageintegerquery預設值: 1
頁碼,從 1 開始。
limitintegerquery預設值: 50
頁面大小,範圍為 1 到 100。

請求

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

請求 / 回應

本頁面提供 OpenAPI 架構與可複製的請求範例。請使用 Management Token 從您的終端機或客戶端發送管理請求;本頁面不支援直接發送請求。

回應範例

回應

200 OK
{
  "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-sonnet-4-6"
      ],
      "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
用於後續 Management API 呼叫的 API key 識別碼。
data[].namestring
API key 的顯示名稱。
data[].key_prefixstring
用於顯示與支援的非機密 key 前綴。
data[].statusstring
active、inactive、suspended 或 revoked 其中之一。
data[].limit_amountnumber | null
以 USD 為單位的消費上限(JSON 數字格式,用於顯示)。null 表示無限制。
data[].limit_amount_decimalstring | null
以 USD 為單位的精確消費上限(十進位字串)。null 表示無限制。
data[].used_amountnumber
以 USD 為單位的累計使用量(JSON 數字格式,用於顯示)。
data[].used_amount_decimalstring
以 USD 為單位的精確累計使用量(十進位字串)。
data[].modelsstring[]
各 key 的模型允許清單。空陣列表示沒有額外的 key 層級模型限制。
data[].delivery_policystring | null
auto、verified、official 或 null。null 表示繼承 Workspace 的傳遞策略。
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