管理
建立 API Key
為當前的 Workspace 建立 API key。
POSThttps://api.tokenlab.sh/v1/management/api-keys
概覽
在與管理 token 關聯的 Workspace 中建立一個 API key。完整的 secret 金鑰僅會在本次回應中顯示一次。
請求主體 (Request Body)
| 欄位 | 類型 | 預設值 / 限制 | 說明 |
|---|---|---|---|
name | string | 選填,預設 Default Key,長度 1-50 | 顯示名稱,伺服器端會進行修剪 |
limitAmount | number | string | null | 0–100000 USD | null 代表無限制;0 表示禁止消費。十進位字串最多支援 6 位小數。建立金鑰時省略此欄位則代表無限制。 |
limitCurrency | enum | 預設 USD | 僅支援 USD。發送 CNY 會回傳 400 currency_retired。 |
models | string[] | 預設 [] | 可選的模型允許清單 (allowlist) |
deliveryPolicy | string | null | auto, verified, official, null | null 將繼承 Workspace 的傳遞策略。 |
expiresAt | string | null | RFC3339 日期時間 | null 代表永不過期 |
注意事項
-
金額欄位僅支援 USD。輸入
CNY已停用並會回傳400 currency_retired。 -
models: []表示不增加金鑰層級的模型限制。 -
limitAmount: 0建立的金鑰雖有效,但在更新前無法消耗配額。
請求
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 從您的終端或客戶端發送管理請求;本頁面不支援直接發送。
回應
{
"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