管理
创建 API 密钥
为当前工作区创建 API 密钥。
POSThttps://api.tokenlab.sh/v1/management/api-keys
在管理令牌所属的工作区创建 API 密钥。完整密钥只会在响应中出现一次，请立即保存。
本页提供 OpenAPI 结构说明和可复制的请求示例。请在终端或客户端使用 Management Token 发送管理请求；本页不提供直接发送功能。
请求体
| 字段 | 类型 | 默认值 / 限制 | 说明 |
|---|---|---|---|
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[] | 默认 [] | 可选的模型白名单 |
deliveryPolicy | string | null | auto, verified, official, null | null 表示继承工作区交付策略。 |
expiresAt | string | null | RFC3339 datetime | 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-3.0-video"],
"expiresAt": "2026-12-31T23:59:59Z"
}'响应
{
"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-3.0-video"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": null,
"created_at": "2026-07-08T03:00:00.000Z",
"delivery_policy": null
}重要字段
keystring
完整 API 密钥，仅在创建时返回一次。
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
请求体
application/json
响应
application/json
application/json
application/json
application/json