You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
管理 Agent Plan
获取套餐用量详情
复制全文
下载 pdf
获取套餐用量详情
POST https://ark.cn-beijing.volcengineapi.com/?Action=GetUsageDetails&Version=2024-01-01​
查询个人版 AgentPlan 套餐的模型调用用量明细。用量按 QueryInterval 指定的时间粒度(天或小时)聚合。企业版席位用量请改用 GetSeatUsageDetails 接口。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
QueryInterval string 必选 | 聚合粒度​
​
Filter object | 过滤条件​
​
​
响应参数​
Details object[] | 明细列表​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetUsageDetails&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 '{
  "QueryInterval": "Day",
  "Filter": {
    "ObjectName": [
        "doubao-seed-1.6",
        "GLM-4.7"
    ],    
    "PlanType": ["Large"],
    "StartTime": "2026-05-01",
    "EndTime": "2026-05-10"
  }
}
'

Response

{
  "ResponseMetadata": {
    "RequestId": "20260511035211B7A29C481EFC026D93",
    "Action": "GetUsageDetails",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Details": [
      {
        "Time": 1778284800000,
        "ObjectName": "doubao-seed-2-1-pro-260915",
        "Usage": 12500,
        "Unit": "Tokens",
        "BillingType": "WithinPlan"
      },
      {
        "Time": 1778284800000,
        "ObjectName": "doubao-seed-2-1-pro-260915",
        "Usage": 8400,
        "Unit": "Tokens",
        "BillingType": "WithinPlan"
      },
      {
        "Time": 1778371200000,
        "ObjectName": "doubao-seed-2-1-pro-260915",
        "Usage": 26800,
        "Unit": "Tokens",
        "BillingType": "WithinPlan"
      },
      {
        "Time": 1778371200000,
        "ObjectName": "doubao-seed-2-1-pro-260915",
        "Usage": 5100,
        "Unit": "Tokens",
        "BillingType": "WithinPlan"
      }
    ]
  }
}
最近更新时间:2026.10.09 14:36:34
这个页面对您有帮助吗?
有用
有用
无用
无用