文档中心

火山方舟

管理 Agent Plan

获取套餐 AFP 额度

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

查询个人版 AgentPlan 套餐的 AFP（Agent Frame Point）额度用量，包含 5 小时、近一天、近一周、近一月四个滚动窗口的配额与已用量。企业版席位用量请改用 GetSeatAFPUsage 接口。

注意

仅适用于个人版 Agent Plan 套餐；企业版席位用量请改用 GetSeatAFPUsage。返回的 Quota / Used 单位为 AFP，时间戳为 epoch 毫秒。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

Access Key 鉴权，请在 Access Key 管理页面，获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数

响应参数

AFPDaily object | 近一天用量

AFPFiveHour object | 5 小时用量

AFPMonthly object | 近一月用量

AFPWeekly object | 近一周用量

PlanType string | 套餐档位

默认

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetAFPUsage&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 '{}
'

Response

{
  "ResponseMetadata": {
    "RequestId": "20260511034034F809E27C4B1D3A6E52",
    "Action": "GetAFPUsage",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "PlanType": "Large",
    "AFPFiveHour": {
      "Quota": "50.0",
      "Used": "12.5",
      "SubscribeTime": 1778788800000,
      "ResetTime": 1778806800000
    },
    "AFPDaily": {
      "Quota": "100.0",
      "Used": "22.5",
      "SubscribeTime": 1778716800000,
      "ResetTime": 1778803200000
    },
    "AFPWeekly": {
      "Quota": "500.0",
      "Used": "150.0",
      "SubscribeTime": 1778457600000,
      "ResetTime": 1779062400000
    },
    "AFPMonthly": {
      "Quota": "2000.0",
      "Used": "850.5",
      "SubscribeTime": 1777939200000,
      "ResetTime": 1780531200000
    }
  }
}

最近更新时间：2026.09.04 20:18:47

这个页面对您有帮助吗？

有用

无用