Skip to main content
PUT
设置或更新单个 API Key 的模型访问策略。请求体直接传 policy 对象。

权限

仅团队的 Owner / Admin 可以调用。Developer、基础用户和财务管理员无权设置。被设置的 API Key 必须属于当前调用方所在的团队。

请求头

string
必填
枚举值:application/json
string
必填
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_enabledselected
  • mode=selected 时,allowedModels 至少包含一个模型。
  • 写入的模型必须属于该团队已开通的模型范围且当前可用;包含已下线、不可用或团队未开通的模型时,请求会被拒绝。
  • 未参与当前模式计算的模型数组会被规范化为空;重复的模型会被去重。返回结果以服务端规范化后的对象为准。
  • source 由服务端管理,写入时忽略。

响应

返回结构与查询 API Key 模型访问策略一致,为规范化后的最新策略对象。
最后修改于 2026年7月22日