# 获取单个/多个席位的 AFP 额度用量

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetSeatAFPUsage&Version=2024-01-01`

查询企业版 `AgentPlanTeam` 模式下，单个或多个席位的 AFP 额度用量，包含 5 小时、近一天、近一周、近一月四个滚动窗口的配额与已用量。个人版用量请改用 *GetAFPUsage* 接口。

> **说明：注意**
>
> 仅适用于企业版 Agent Plan 套餐；个人版套餐用量请改用 GetAFPUsage。单次请求最多传入 1000 个席位 ID，返回的 Quota / Used 单位为 AFP，时间戳为 epoch 毫秒。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

---

<span id="request-parameters"></span>
## 请求参数

### Body 参数

**SeatIDs** `string[]` `必选` | 席位 ID 列表

待查询的席位 ID 列表，单次请求最多支持传入 1000 个。

## 响应参数

**SeatAFPUsages** `object[]` | 用量列表

按请求顺序返回的席位 AFP 用量列表。

**AFPDaily** `object` | 近一天用量

`SeatAFPUsages.AFPDaily`

近 1 天滚动窗口的 AFP 用量。

适用于图片生成模型、视频生成模型、语音模型和 Harness。上述能力不受 5 小时额度和周额度限制，仅受模型日额度及套餐月额度限制。对于不适用日额度限制的模型，该字段返回 `0`。

**Quota** `string` | 窗口总配额

`SeatAFPUsages.AFPDaily.Quota`

该窗口内的 AFP 总配额。

**ResetTime** `integer` | 下次重置时间

`SeatAFPUsages.AFPDaily.ResetTime`

下一次额度重置的时间，Unix 毫秒时间戳。

**SubscribeTime** `integer` | 窗口起始时间

`SeatAFPUsages.AFPDaily.SubscribeTime`

当前计费窗口的起始时间，Unix 毫秒时间戳。

**Used** `string` | 窗口已用量

`SeatAFPUsages.AFPDaily.Used`

该窗口内已消耗的 AFP 配额。

**AFPFiveHour** `object` | 5 小时用量

`SeatAFPUsages.AFPFiveHour`

近 5 小时滚动窗口的 AFP 用量。

**Quota** `string` | 窗口总配额

`SeatAFPUsages.AFPFiveHour.Quota`

该窗口内的 AFP 总配额。

**ResetTime** `integer` | 下次重置时间

`SeatAFPUsages.AFPFiveHour.ResetTime`

下一次额度重置的时间，Unix 毫秒时间戳。

**SubscribeTime** `integer` | 窗口起始时间

`SeatAFPUsages.AFPFiveHour.SubscribeTime`

当前计费窗口的起始时间，Unix 毫秒时间戳。

**Used** `string` | 窗口已用量

`SeatAFPUsages.AFPFiveHour.Used`

该窗口内已消耗的 AFP 配额。

**AFPMonthly** `object` | 近一月用量

`SeatAFPUsages.AFPMonthly`

近 1 个月滚动窗口的 AFP 用量。

**Quota** `string` | 窗口总配额

`SeatAFPUsages.AFPMonthly.Quota`

该窗口内的 AFP 总配额。

**ResetTime** `integer` | 下次重置时间

`SeatAFPUsages.AFPMonthly.ResetTime`

下一次额度重置的时间，Unix 毫秒时间戳。

**SubscribeTime** `integer` | 窗口起始时间

`SeatAFPUsages.AFPMonthly.SubscribeTime`

当前计费窗口的起始时间，Unix 毫秒时间戳。

**Used** `string` | 窗口已用量

`SeatAFPUsages.AFPMonthly.Used`

该窗口内已消耗的 AFP 配额。

**AFPWeekly** `object` | 近一周用量

`SeatAFPUsages.AFPWeekly`

近 1 周滚动窗口的 AFP 用量。

**Quota** `string` | 窗口总配额

`SeatAFPUsages.AFPWeekly.Quota`

该窗口内的 AFP 总配额。

**ResetTime** `integer` | 下次重置时间

`SeatAFPUsages.AFPWeekly.ResetTime`

下一次额度重置的时间，Unix 毫秒时间戳。

**SubscribeTime** `integer` | 窗口起始时间

`SeatAFPUsages.AFPWeekly.SubscribeTime`

当前计费窗口的起始时间，Unix 毫秒时间戳。

**Used** `string` | 窗口已用量

`SeatAFPUsages.AFPWeekly.Used`

该窗口内已消耗的 AFP 配额。

**PlanType** `string` | 套餐档位

`SeatAFPUsages.PlanType`

该席位所属的套餐档位。取值：`Small`、`Medium`、`Large`、`Max`。

**SeatID** `string` | 席位 ID

`SeatAFPUsages.SeatID`

该条用量记录对应的席位 ID。


## 代码示例

## 默认

### cURL

#### Request

```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetSeatAFPUsage&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
  "SeatIDs": ["S7HQ2KP", "S3MR9XT"]
}
'
```

#### Response

```
{
  "ResponseMetadata": {
    "RequestId": "20260511044821D40F827A91BCE43A67",
    "Action": "GetSeatAFPUsage",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "SeatAFPUsages": [
      {
        "SeatID": "seat-agt-mx-001",
        "PlanType": "Max",
        "AFPFiveHour": {
          "Quota": "100.0",
          "Used": "42.3",
          "SubscribeTime": 1778788800000,
          "ResetTime": 1778806800000
        },
        "AFPDaily": {
          "Quota": "200.0",
          "Used": "78.1",
          "SubscribeTime": 1778716800000,
          "ResetTime": 1778803200000
        },
        "AFPWeekly": {
          "Quota": "1000.0",
          "Used": "421.5",
          "SubscribeTime": 1778457600000,
          "ResetTime": 1779062400000
        },
        "AFPMonthly": {
          "Quota": "4000.0",
          "Used": "1872.8",
          "SubscribeTime": 1777939200000,
          "ResetTime": 1780531200000
        }
      },
      {
        "SeatID": "seat-agt-lg-001",
        "PlanType": "Large",
        "AFPFiveHour": {
          "Quota": "50.0",
          "Used": "5.3",
          "SubscribeTime": 1778788800000,
          "ResetTime": 1778806800000
        },
        "AFPDaily": {
          "Quota": "100.0",
          "Used": "12.1",
          "SubscribeTime": 1778716800000,
          "ResetTime": 1778803200000
        },
        "AFPWeekly": {
          "Quota": "500.0",
          "Used": "53.7",
          "SubscribeTime": 1778457600000,
          "ResetTime": 1779062400000
        },
        "AFPMonthly": {
          "Quota": "2000.0",
          "Used": "128.4",
          "SubscribeTime": 1777939200000,
          "ResetTime": 1780531200000
        }
      }
    ]
  }
}
```