查询 API 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
      }
    }
  ]
}

GET

openapi

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

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。

object

模型访问摘要，仅在 includePolicySummary=true 时返回。

显示 properties

string

必填

访问模式。取值：all_enabled、selected。

int32

必填

可访问模型数量。

int32

必填

已排除模型数量。

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日

按消费金额检查 API Key 预算是否充足查询 API Key 模型访问策略

账单管理

Quota 管理

预算管理

API Key 模型访问

查询 API Key 列表（含模型访问摘要）

权限

请求头

查询参数

响应参数

​权限

​请求头

​查询参数

​响应参数

权限

请求头

查询参数

响应参数