curl --request GET \
--url 'https://api.ppio.com/openapi/v2/user/key?includePolicySummary=true' \
--header 'Authorization: Bearer <API_KEY>'
{
"keys": [
{
"name": "default",
"id": "123456",
"stringId": "key_xxx",
"maskedKey": "sk_xxx***",
"memberId": "member_xxx",
"uuid": "user_uuid_xxx",
"expireTime": "never",
"createTime": "2026-07-14 12:00:00",
"lastUsedAt": 1783764000,
"modelAccessPolicy": {
"mode": "selected",
"allowedModelCount": 1,
"excludedModelCount": 0
}
}
]
}
API Key 模型访问
查询 API Key 列表（含模型访问摘要）
GET
/
openapi
/
v2
/
user
/
key
curl --request GET \
--url 'https://api.ppio.com/openapi/v2/user/key?includePolicySummary=true' \
--header 'Authorization: Bearer <API_KEY>'
{
"keys": [
{
"name": "default",
"id": "123456",
"stringId": "key_xxx",
"maskedKey": "sk_xxx***",
"memberId": "member_xxx",
"uuid": "user_uuid_xxx",
"expireTime": "never",
"createTime": "2026-07-14 12:00:00",
"lastUsedAt": 1783764000,
"modelAccessPolicy": {
"mode": "selected",
"allowedModelCount": 1,
"excludedModelCount": 0
}
}
]
}
查询当前团队的 API Key 列表。带上
includePolicySummary=true 时，每个 Key 会返回 modelAccessPolicy 摘要，便于在列表页展示模型访问状态。页面初始化时建议直接调用本接口拿到摘要，再按需查询单个 Key 的完整策略。
权限
按平台现有 API Key 读取权限返回：Owner / Admin 可查询团队内全部 Key；Developer / 基础用户按其可访问范围返回自己拥有的 Key。请求头
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。
查询参数
boolean
是否返回每个 Key 的
modelAccessPolicy 摘要。建议前端默认传 true。不传或为 false 时，modelAccessPolicy 可能不返回。响应参数
object[]
必填
API Key 列表。
隐藏 properties
隐藏 properties
string
必填
API Key 名称。
string
必填
API Key 的数字 ID。
string
必填
API Key 的 stringId，用于模型访问策略等接口的路径参数。
string
必填
脱敏后的 API Key，例如
sk_xxx***。列表接口不返回明文密钥；明文仅在创建时返回一次。string
必填
API Key 所属成员的子用户账号 ID。
string
必填
API Key 所属用户的 UUID。
string
必填
过期时间。永不过期时为
never。string
必填
创建时间。
int64
必填
最近一次使用时间，Unix 时间戳（秒）。从未使用时为
0。curl --request GET \
--url 'https://api.ppio.com/openapi/v2/user/key?includePolicySummary=true' \
--header 'Authorization: Bearer <API_KEY>'
{
"keys": [
{
"name": "default",
"id": "123456",
"stringId": "key_xxx",
"maskedKey": "sk_xxx***",
"memberId": "member_xxx",
"uuid": "user_uuid_xxx",
"expireTime": "never",
"createTime": "2026-07-14 12:00:00",
"lastUsedAt": 1783764000,
"modelAccessPolicy": {
"mode": "selected",
"allowedModelCount": 1,
"excludedModelCount": 0
}
}
]
}
最后修改于 2026年7月22日