新建 API Key
POST /api/token/
说明
为当前用户创建一个新的 API Key。
- 数量受系统配置
MaxUserTokens限制 name长度 ≤ 50unlimited_quota=false时remain_quota必须 ≥ 0 且 ≤1_000_000_000 * QuotaPerUnitgroup若不是auto/ 空,必须是已存在的分组(多分组逗号分隔)- 创建成功后不会在响应中返回明文 key,需要再调用「获取 API Key 明文」拿明文
请求头
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| Authorization | header | string | 是 | 系统访问令牌 |
| New-Api-User | header | string | 是 | 用户 ID |
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | Key 名称,长度 ≤ 50 |
| expired_time | integer | 否 | 过期时间戳(秒);-1 表示永不过期 |
| remain_quota | integer | 否 | 剩余额度(系统最小单位);unlimited_quota=true 时忽略 |
| unlimited_quota | boolean | 否 | 是否无限额度 |
| model_limits_enabled | boolean | 否 | 是否启用模型限制 |
| model_limits | string | 否 | 逗号分隔的允许模型名,仅在 model_limits_enabled=true 时生效 |
| allow_ips | string | 否 | 换行分隔的 CIDR(如 192.168.0.0/16);留空不限制 |
| group | string | 否 | 分组:空=跟随用户,auto=自动调度,多分组逗号分隔(多分组不能含 auto) |
| cross_group_retry | boolean | 否 | 跨分组重试,仅 auto 分组生效 |
响应
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | boolean | 否 | |
| message | string | 否 |