POST
创建 API 密钥

授权

Authorization
string
header
必填

个人访问令牌(nap_ 开头),在控制台「安全与访问 → 访问令牌」中创建,不是 sk- 开头的 API 密钥。

请求体

application/json
name
string
必填

密钥名称,最多 50 个字符

示例:

"my-key"

remain_quota
integer

额度(内部额度单位)。unlimited_quota 为 true 时忽略

示例:

500000

unlimited_quota
boolean

是否无限额度

示例:

false

expired_time
integer

过期时间(Unix 秒),-1 表示永不过期

示例:

-1

model_limits_enabled
boolean

是否启用模型限制

示例:

false

model_limits
string

允许调用的模型,逗号分隔;启用模型限制时生效

示例:

""

allow_ips
string

IP 白名单,每行一个;为空表示不限制

示例:

""

group
string

密钥分组;为空表示使用账户分组

示例:

""

cross_group_retry
boolean

跨分组重试,仅 group 为 auto 时有效

示例:

false

auto_groups
string[]

group 为 auto 时依次尝试的分组

allow_user_quota_query
boolean

是否允许用这个密钥查询账户余额,新建时默认开启

示例:

true

响应

200 - application/json

成功

success
boolean

是否成功

示例:

true

message
string

失败时为错误原因

示例:

""