curl --request GET \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>'
{
"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"
}
{
"stringId": "key_xxx",
"policy": {
"schemaVersion": 1,
"productScope": "model_api",
"mode": "all_enabled",
"allowedModels": [],
"excludedModels": [],
"source": {
"type": "default"
}
},
"policyStatus": "active",
"allowedModelCount": 0,
"excludedModelCount": 0,
"updatedAt": 0,
"updatedBy": ""
}
API Key 模型访问
查询 API Key 模型访问策略
GET
/
openapi
/
v2
/
user
/
key
/
{stringId}
/
model-access-policy
curl --request GET \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>'
{
"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"
}
{
"stringId": "key_xxx",
"policy": {
"schemaVersion": 1,
"productScope": "model_api",
"mode": "all_enabled",
"allowedModels": [],
"excludedModels": [],
"source": {
"type": "default"
}
},
"policyStatus": "active",
"allowedModelCount": 0,
"excludedModelCount": 0,
"updatedAt": 0,
"updatedBy": ""
}
查询单个 API Key 当前的模型访问策略。如果该 Key 从未单独配置过，返回默认策略（
被查询的 API Key 必须属于当前调用方所在的团队。
mode=all_enabled）。
allowedModels / excludedModels 实际可能返回 null 或空数组，调用方建议统一按空数组处理。权限
| 角色 | 是否可查询 |
|---|---|
| Owner / Admin | 可查询团队内任意 API Key 的完整策略。 |
| Developer | 只能查询自己拥有的 API Key，且响应中不返回 allowedModels / excludedModels 明细。 |
请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
路径参数
string
必填
目标 API Key 的 stringId。
响应参数
string
必填
API Key 的 stringId。
object
必填
模型访问策略对象。
隐藏 properties
隐藏 properties
int32
必填
策略结构版本号，当前为
1。string
必填
策略适用的产品范围。当前仅支持
model_api。string
必填
访问模式。取值：
all_enabled（可访问全部已开通模型）、selected（仅可访问指定模型）。object[]
object[]
已排除的模型列表。仅在
mode=all_enabled 时有意义；mode=selected 时为空。字段结构同 allowedModels。Developer 查询时不返回该明细。string
必填
策略状态。
active 表示策略有效；no_available_models 表示当前无可访问模型（例如已选模型全部下线）。int32
必填
可访问模型数量。
int32
必填
已排除模型数量。
int64
必填
最近一次更新时间，Unix 时间戳（秒）。默认策略下为
0。string
必填
最近一次更新操作者的用户标识。默认策略下为空字符串。
curl --request GET \
--url https://api.ppio.com/openapi/v2/user/key/<stringId>/model-access-policy \
--header 'Authorization: Bearer <API_KEY>'
{
"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"
}
{
"stringId": "key_xxx",
"policy": {
"schemaVersion": 1,
"productScope": "model_api",
"mode": "all_enabled",
"allowedModels": [],
"excludedModels": [],
"source": {
"type": "default"
}
},
"policyStatus": "active",
"allowedModelCount": 0,
"excludedModelCount": 0,
"updatedAt": 0,
"updatedBy": ""
}
最后修改于 2026年7月22日
⌘I