API Key 模型访问
设置 API Key 模型访问策略
PUT
设置或更新单个 API Key 的模型访问策略。请求体直接传
policy 对象。
权限
仅团队的 Owner / Admin 可以调用。Developer、基础用户和财务管理员无权设置。被设置的 API Key 必须属于当前调用方所在的团队。请求头
string
必填
枚举值:
application/jsonstring
必填
Bearer 身份验证格式,例如:Bearer {{API 密钥}}。
路径参数
string
必填
目标 API Key 的 stringId。
请求体
int32
策略结构版本号,当前为
1。string
策略适用的产品范围。传入时仅支持
model_api。string
必填
访问模式。取值:
all_enabled(可访问全部已开通模型)、selected(仅可访问指定模型)。object[]
可访问的模型列表。
mode=selected 时必填,且至少包含一个模型;mode=all_enabled 时会被忽略。object[]
已排除的模型列表。
mode=all_enabled 时生效;mode=selected 时会被忽略。字段结构同 allowedModels。写入约束:
mode必须是all_enabled或selected。mode=selected时,allowedModels至少包含一个模型。- 写入的模型必须属于该团队已开通的模型范围且当前可用;包含已下线、不可用或团队未开通的模型时,请求会被拒绝。
- 未参与当前模式计算的模型数组会被规范化为空;重复的模型会被去重。返回结果以服务端规范化后的对象为准。
source由服务端管理,写入时忽略。
响应
返回结构与查询 API Key 模型访问策略一致,为规范化后的最新策略对象。最后修改于 2026年7月22日