火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟管控面 API管理 Agent / Coding Plan管理 Agent Plan（企业版）获取单个/多个席位的 AFP 额度用量
复制全文
下载 pdf获取单个/多个席位的 AFP 额度用量
文档反馈
问问助手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 毫秒。
鉴权
- Access Key 鉴权，请在 Access Key 管理 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。
请求参数
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。
默认
Request
cURL
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
}
}
]
}
}最近更新时间：2026.09.08 18:00:35
这个页面对您有帮助吗？
有用
有用
无用
无用