管理
更新 API 密钥
更新当前工作区的 API 密钥。
PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}
修改 API 密钥的名称、额度、模型白名单、过期时间或状态。
本页提供 OpenAPI 结构说明和可复制的请求示例。请在终端或客户端使用 Management Token 发送管理请求；本页不提供直接发送功能。
请求体
PATCH 请求至少需要提供一个字段。
| 字段 | 类型 | 默认值 / 限制 | 说明 |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | 长度 1-50 | 更新后的展示名称 |
limitAmount | number | string | null | 0–100000 USD | null 表示不限额，0 表示不能产生费用。十进制字符串最多支持 6 位小数。 |
limitCurrency | enum | 默认 USD | 仅支持 USD。发送 CNY 会返回 400 currency_retired。 设置时必须同时提供 limitAmount。 |
models | string[] | - | 更新后的模型白名单 |
deliveryPolicy | string | null | auto, verified, official, null | null 表示继承工作区交付策略。 |
expiresAt | string | null | RFC3339 datetime | null 表示清除过期时间 |
说明
-
金额字段仅支持 USD。
CNY输入已停用，并会返回400 currency_retired。 -
管理 API 不提供删除接口。临时停用使用
inactive，永久停用使用revoked。 -
已撤销的密钥需要由新密钥替代。
请求
curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"status": "inactive",
"limitAmount": 0
}'响应
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "inactive",
"limit_amount": 0,
"limit_amount_decimal": "0",
"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
}重要字段
idstring
密钥 ID。
namestring
API 密钥的显示名称。
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 表示继承工作区交付策略。expires_atstring | null
密钥到期时间；
null 表示永不过期。last_used_atstring | null
最近一次使用的 ISO 时间戳；从未使用时为
null。created_atstring
创建时间的 ISO 时间戳。
授权
ManagementTokenAuth AuthorizationBearer <token>
管理令牌身份验证。在 Dashboard > API > Management Tokens 中创建或管理管理令牌。
位置: header
路径参数
keyId*string
请求体
application/json
必须至少提供一个字段。
属性
1 <= properties响应
application/json
application/json
application/json
application/json
application/json
application/json