新建 API Key

POST /api/token/

说明

为当前用户创建一个新的 API Key。

  • 数量受系统配置 MaxUserTokens 限制
  • name 长度 ≤ 50
  • unlimited_quota=falseremain_quota 必须 ≥ 0 且 ≤ 1_000_000_000 * QuotaPerUnit
  • group 若不是 auto / 空,必须是已存在的分组(多分组逗号分隔)
  • 创建成功后不会在响应中返回明文 key,需要再调用「获取 API Key 明文」拿明文

请求头

名称位置类型必填说明
Authorizationheaderstring系统访问令牌
New-Api-Userheaderstring用户 ID

请求体

字段类型必填说明
namestringKey 名称,长度 ≤ 50
expired_timeinteger过期时间戳(秒);-1 表示永不过期
remain_quotainteger剩余额度(系统最小单位);unlimited_quota=true 时忽略
unlimited_quotaboolean是否无限额度
model_limits_enabledboolean是否启用模型限制
model_limitsstring逗号分隔的允许模型名,仅在 model_limits_enabled=true 时生效
allow_ipsstring换行分隔的 CIDR(如 192.168.0.0/16);留空不限制
groupstring分组:空=跟随用户,auto=自动调度,多分组逗号分隔(多分组不能含 auto)
cross_group_retryboolean跨分组重试,仅 auto 分组生效

响应

字段类型必填说明
successboolean
messagestring