curl --request PUT \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"schemaVersion": 1,
"productScope": "model_api",
"mode": "selected",
"allowedModels": [
{ "type": "llm", "id": "deepseek/deepseek-v3" }
]
}'
curl --request PUT \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"schemaVersion": 1,
"productScope": "model_api",
"mode": "all_enabled"
}'
{
"stringId": "key_xxx",
"policy": {
"schemaVersion": 1,
"productScope": "model_api",
"mode": "selected",
"allowedModels": [
{
"type": "llm",
"id": "deepseek/deepseek-v3"
}
],
"excludedModels": [],
"source": {
"type": "private_policy"
}
},
"policyStatus": "active",
"allowedModelCount": 1,
"excludedModelCount": 0,
"updatedAt": 1783764000,
"updatedBy": "user_uuid_xxx"
}
API Key 模型访问
设置 API Key 模型访问策略
PUT
/
openapi
/
v2
/
user
/
key
/
{stringId}
/
model-access-policy
curl --request PUT \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"schemaVersion": 1,
"productScope": "model_api",
"mode": "selected",
"allowedModels": [
{ "type": "llm", "id": "deepseek/deepseek-v3" }
]
}'
curl --request PUT \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"schemaVersion": 1,
"productScope": "model_api",
"mode": "all_enabled"
}'
{
"stringId": "key_xxx",
"policy": {
"schemaVersion": 1,
"productScope": "model_api",
"mode": "selected",
"allowedModels": [
{
"type": "llm",
"id": "deepseek/deepseek-v3"
}
],
"excludedModels": [],
"source": {
"type": "private_policy"
}
},
"policyStatus": "active",
"allowedModelCount": 1,
"excludedModelCount": 0,
"updatedAt": 1783764000,
"updatedBy": "user_uuid_xxx"
}
设置或更新单个 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[]
object[]
已排除的模型列表。
mode=all_enabled 时生效；mode=selected 时会被忽略。字段结构同 allowedModels。写入约束：
mode必须是all_enabled或selected。mode=selected时，allowedModels至少包含一个模型。- 写入的模型必须属于该团队已开通的模型范围且当前可用；包含已下线、不可用或团队未开通的模型时，请求会被拒绝。
- 未参与当前模式计算的模型数组会被规范化为空；重复的模型会被去重。返回结果以服务端规范化后的对象为准。
source由服务端管理，写入时忽略。
响应
返回结构与查询 API Key 模型访问策略一致，为规范化后的最新策略对象。curl --request PUT \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"schemaVersion": 1,
"productScope": "model_api",
"mode": "selected",
"allowedModels": [
{ "type": "llm", "id": "deepseek/deepseek-v3" }
]
}'
curl --request PUT \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"schemaVersion": 1,
"productScope": "model_api",
"mode": "all_enabled"
}'
{
"stringId": "key_xxx",
"policy": {
"schemaVersion": 1,
"productScope": "model_api",
"mode": "selected",
"allowedModels": [
{
"type": "llm",
"id": "deepseek/deepseek-v3"
}
],
"excludedModels": [],
"source": {
"type": "private_policy"
}
},
"policyStatus": "active",
"allowedModelCount": 1,
"excludedModelCount": 0,
"updatedAt": 1783764000,
"updatedBy": "user_uuid_xxx"
}
最后修改于 2026年7月22日