> ## 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.

# 查询 Quota 列表

## 请求头

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

## 查询参数

<ParamField query="modal" type="string" required={false}>
  Quota 所属模态。常用值：`llm`、`image`。
</ParamField>

<ParamField query="quotaType" type="string" required={false}>
  Quota 类型。常用值：`RPM`、`TPM`、`IPM`。
</ParamField>

<ParamField query="productType" type="string" required={false}>
  产品类型。常用值：`Public Endpoint`。
</ParamField>

<ParamField query="quotaObject" type="string" required={false}>
  Quota 对象。模型场景下可传模型 ID，例如 `deepseek-v3`。服务端支持模糊匹配；为空时返回当前账号可见的全部 Quota。
</ParamField>

## 响应参数

<ResponseField name="data" type="object[]" required={true}>
  Quota 列表。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="modal" type="string" required={true}>
      Quota 所属模态。
    </ResponseField>

    <ResponseField name="quotaObject" type="string" required={true}>
      Quota 对象展示名称。模型场景下通常为模型名称或模型 ID。
    </ResponseField>

    <ResponseField name="quotaType" type="string" required={true}>
      Quota 类型。
    </ResponseField>

    <ResponseField name="productType" type="string" required={true}>
      产品类型。
    </ResponseField>

    <ResponseField name="currentQuota" type="int32" required={true}>
      当前账号的 Quota 限额。
    </ResponseField>

    <ResponseField name="defaultQuota" type="int32" required={true}>
      默认 Quota 限额。
    </ResponseField>

    <ResponseField name="adjustable" type="bool" required={true}>
      是否支持申请调整 Quota。
    </ResponseField>

    <ResponseField name="quotaItems" type="object[]" required={true}>
      不同账号等级对应的 Quota 限额。

      <Expandable title="properties" defaultOpen={true}>
        <ResponseField name="tier" type="string" required={true}>
          账号等级。例如：`T1`、`T2`、`T3`、`T4`、`T5`。
        </ResponseField>

        <ResponseField name="quota" type="int32" required={true}>
          该账号等级对应的 Quota 限额。
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="int32" required={true}>
  返回的 Quota 数量。
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://api.ppio.com/openapi/v1/user/quota/list?modal=llm&quotaType=RPM&productType=Public%20Endpoint&quotaObject=deepseek-v3' \
    --header 'Authorization: Bearer <API_KEY>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "modal": "llm",
        "quotaObject": "deepseek-v3",
        "quotaType": "RPM",
        "productType": "Public Endpoint",
        "currentQuota": 60,
        "defaultQuota": 60,
        "adjustable": true,
        "quotaItems": [
          {
            "tier": "T1",
            "quota": 60
          },
          {
            "tier": "T2",
            "quota": 120
          }
        ]
      }
    ],
    "total": 1
  }
  ```
</ResponseExample>