> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询成员名下 API Key 预算列表

## 请求头

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 查询参数

<ParamField query="member_id" type="string" required={true}>
  要查询的子用户账号 ID。
</ParamField>

## 响应参数

<ResponseField name="key_budgets" type="object[]" required={true}>
  API Key 预算列表。未配置预算的 API Key 会以默认值（budget\_type=Unlimited、used=0、budget\_limit=0）出现在列表中。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="key_id" type="string" required={true}>
      API Key ID。
    </ResponseField>

    <ResponseField name="key_name" type="string" required={true}>
      API Key 名称。
    </ResponseField>

    <ResponseField name="budget_type" type="string" required={true}>
      预算类型。取值：`Unlimited`（无限制）、`One-time`（一次性）、`Recurring`（循环）。
    </ResponseField>

    <ResponseField name="budget_limit" type="int64" required={true}>
      预算上限，单位为 1/10000 元（即 10000 = 1 元）。
    </ResponseField>

    <ResponseField name="used" type="int64" required={true}>
      已用额度，单位为 1/10000 元（即 10000 = 1 元）。
    </ResponseField>

    <ResponseField name="remaining" type="int64" required={true}>
      剩余额度，单位为 1/10000 元（即 10000 = 1 元）。当使用量超出限额时，该值可能为负数。
    </ResponseField>

    <ResponseField name="cycle" type="string" required={false}>
      重置周期，仅在 `budget_type=Recurring` 时有值。当前仅支持 `Monthly`（按月）。
    </ResponseField>

    <ResponseField name="period_start" type="string" required={false}>
      当前周期开始时间，ISO 8601 格式。仅在 `budget_type=Recurring` 时有值。
    </ResponseField>

    <ResponseField name="period_end" type="string" required={false}>
      当前周期结束时间，ISO 8601 格式。仅在 `budget_type=Recurring` 时有值。
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://api.ppio.com/openapi/v1/user/team/key-budget-list?member_id=<string>' \
    --header 'Authorization: Bearer <API_KEY>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "key_budgets": [
      {
        "key_id": "<string>",
        "key_name": "<string>",
        "budget_type": "<string>",
        "budget_limit": 0,
        "used": 0,
        "remaining": 0,
        "cycle": "<string>",
        "period_start": "<string>",
        "period_end": "<string>"
      }
    ]
  }
  ```
</ResponseExample>