TokenLab

管理

建立 API Key

為當前的 Workspace 建立 API key。

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

概覽

在與管理 token 關聯的 Workspace 中建立一個 API key。完整的 secret 金鑰僅會在本次回應中顯示一次。

請求主體 (Request Body)

欄位類型預設值 / 限制說明
namestring選填,預設 Default Key,長度 1-50顯示名稱,伺服器端會進行修剪
limitAmountnumber | string | null0–100000 USDnull 代表無限制;0 表示禁止消費。十進位字串最多支援 6 位小數。建立金鑰時省略此欄位則代表無限制。
limitCurrencyenum預設 USD僅支援 USD。發送 CNY 會回傳 400 currency_retired。
modelsstring[]預設 []可選的模型允許清單 (allowlist)
deliveryPolicystring | nullauto, verified, official, nullnull 將繼承 Workspace 的傳遞策略。
expiresAtstring | nullRFC3339 日期時間null 代表永不過期

注意事項

  • 金額欄位僅支援 USD。輸入 CNY 已停用並會回傳 400 currency_retired。

  • models: [] 表示不增加金鑰層級的模型限制。

  • limitAmount: 0 建立的金鑰雖有效,但在更新前無法消耗配額。

範例

請求

cURL
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Backend Worker",
    "limitAmount": 500,
    "models": ["veo3.1", "kling-v3.0"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

請求 / 回應

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

回應範例

回應

201 Created
{
  "id": "key_abc123def456",
  "name": "Backend Worker",
  "key": "sk-live-redacted",
  "key_prefix": "sk-live...",
  "status": "active",
  "limit_amount": 500,
  "limit_amount_decimal": "500",
  "used_amount": 0,
  "used_amount_decimal": "0",
  "models": [
    "veo3.1",
    "kling-v3.0"
  ],
  "expires_at": "2026-12-31T23:59:59.000Z",
  "last_used_at": null,
  "created_at": "2026-07-08T03:00:00.000Z",
  "delivery_policy": null
}

重要欄位

keystring
完整的 secret API key 值。僅在建立時回傳一次。
idstring
用於後續 Management API 呼叫的 API key 識別碼。
namestring
API key 的顯示名稱。
key_prefixstring
非機密金鑰前綴,用於顯示與支援。
statusstring
狀態,可為 active、inactive、suspended 或 revoked 其中之一。
limit_amountnumber | null
以 JSON 數字格式顯示的 USD 消費上限。null 代表無限制。
limit_amount_decimalstring | null
以十進位字串格式表示的精確 USD 消費上限。null 代表無限制。
used_amountnumber
以 JSON 數字格式顯示的累計 USD 使用量。
used_amount_decimalstring
以十進位字串格式表示的精確累計 USD 使用量。
modelsstring[]
個別金鑰的模型允許清單。空陣列表示沒有額外的金鑰層級模型限制。
delivery_policystring | null
auto、verified、official、null。null 代表繼承 Workspace 的傳遞策略。
expires_atstring | null
金鑰過期的 ISO 時間戳記,或 null 表示永不過期。
last_used_atstring | null
最近一次使用的 ISO 時間戳記,若未使用則為 null。
created_atstring
建立時的 ISO 時間戳記。

授權

ManagementTokenAuth
AuthorizationBearer <token>

管理權杖驗證。請在 Dashboard > API > Management Tokens 建立或管理管理權杖。

位置: header

請求主體

application/json

回應

application/json

application/json

application/json

application/json