# 查询单请求用量
> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。
`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceRequestUsage&Version=2024-01-01`
根据 `RequestID` 查询指定小时内当前账号下某个同步推理请求的用量明细。
## 鉴权
本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。
* Access Key 鉴权，请在 [Access Key 管理](https://console.volcengine.com/iam/keymanage) 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。
---
## 请求参数
### Body 参数
**QueryHour** `string` `必选` | 查询小时
请求记录所在小时的起始时间，格式为 `YYYY-MM-DD HH:00:00`。分钟和秒必须为 `00`。默认使用北京时间（Asia/Shanghai）；其他环境以其查询时区配置为准。
**RequestID** `string` `必选` | 请求 ID
待查询的同步推理请求 ID。
> **说明**
>
> `RequestID` 为同步推理请求在响应体中返回的 `id`。
## 响应参数
**Records** `object[]` | 用量明细
同步请求用量明细数组。一个 `RequestID` 可能对应多条用量记录，接口会在该数组中返回全部明细。
**AccountantEndTime** `integer` | 账期结束时间
`Records.AccountantEndTime`
账期结束时间，Unix 时间戳，单位为秒，不包含该时间点。仅当 `BillingStatus` 严格等于 `normal` 时返回。
**AccountantStartTime** `integer` | 账期开始时间
`Records.AccountantStartTime`
账期开始时间，Unix 时间戳，单位为秒，包含该时间点。仅当 `BillingStatus` 严格等于 `normal` 时返回。
**AccountID** `integer` | 账号 ID
`Records.AccountID`
记录所属的账号 ID。有记录时返回。
**APIKeyID** `string` | API Key 标识
`Records.APIKeyID`
请求使用的 API Key 标识，不是 API Key 密钥内容。有记录时返回。
**AudioCachedTokens** `integer` | 音频缓存 Token 数
`Records.AudioCachedTokens`
音频缓存 Token 数。返回 Token 用量组时返回。
**AudioOriginalDurationMs** `integer` | 原始音频时长
`Records.AudioOriginalDurationMs`
原始音频时长，单位为毫秒。返回音频用量组时返回。
**AudioTaskType** `string` | 音频任务类型
`Records.AudioTaskType`
音频任务类型。返回音频用量组时返回。
**AudioTokens** `integer` | 音频 Token 数
`Records.AudioTokens`
音频 Token 数。返回 Token 用量组时返回。
**BatchJobID** `string` | 批处理任务 ID
`Records.BatchJobID`
批处理任务 ID。非空时返回。
**BillingStatus** `string` | 计费状态
`Records.BillingStatus`
计费状态，例如 `normal`。有记录时返回。
**CacheHitTokens** `integer` | 缓存命中 Token 数
`Records.CacheHitTokens`
缓存命中 Token 数。返回 Token 用量组时返回。
**DeploymentType** `string` | 部署类型
`Records.DeploymentType`
部署类型。非空时返回。
**ErrorCode** `string` | 错误码
`Records.ErrorCode`
原推理请求记录中的错误码。非空时返回。
**ImageNumber** `integer` | 图片数量
`Records.ImageNumber`
图片数量。返回图片用量组时返回。
**InputImageCount** `integer` | 输入图片数量
`Records.InputImageCount`
输入图片数量。返回图片用量组时返回。
**InputTokens** `integer` | 输入 Token 数
`Records.InputTokens`
输入 Token 数。返回 Token 用量组时返回。
**IsBatch** `boolean` | 是否为 batch 请求
`Records.IsBatch`
是否为 batch 请求。仅值为 `true` 时返回。
**IsFast** `boolean` | 是否为 fast 请求
`Records.IsFast`
是否为 fast 请求。仅值为 `true` 时返回。
**IsFlex** `boolean` | 是否为 flex 请求
`Records.IsFlex`
是否为 flex 请求。仅值为 `true` 时返回。
**IsOffpeak** `boolean` | 是否为 offpeak 请求
`Records.IsOffpeak`
是否为 offpeak 请求。仅值为 `true` 时返回。
**ManagedAgentID** `string` | 托管 Agent ID
`Records.ManagedAgentID`
托管 Agent ID。非空时返回。
**ModelEndpoint** `string` | 推理接入点 ID
`Records.ModelEndpoint`
推理接入点 ID。有记录时返回。
**ModelName** `string` | 模型名称
`Records.ModelName`
模型名称。有记录时返回。
**ModelUnitID** `string` | 模型单元 ID
`Records.ModelUnitID`
模型单元 ID。非空时返回。
**ModelVersion** `string` | 模型版本
`Records.ModelVersion`
模型版本。有记录时返回。
**OutputTokens** `integer` | 输出 Token 数
`Records.OutputTokens`
输出 Token 数。返回 Token 用量组时返回。
**PlanChargedAFP** `string` | Plan 计费 AFP
`Records.PlanChargedAFP`
Plan 计费值，以十进制字符串保留精度。属于 Plan、未透支且计费值存在时返回。
**PlanEdition** `string` | Plan 版本
`Records.PlanEdition`
Plan 版本。属于 Plan 且未透支时返回。
**PlanPack** `string` | Plan 套餐包标识
`Records.PlanPack`
Plan 套餐包标识。属于 Plan 且未透支时返回。
**PlanScene** `string` | Plan 场景
`Records.PlanScene`
Plan 场景。属于 Plan 且未透支时返回。
**PlanSeatID** `string` | Plan 席位 ID
`Records.PlanSeatID`
Plan 席位 ID。属于 Plan 且未透支时返回。
**PlanSharedPackageID** `string` | 共享包 ID
`Records.PlanSharedPackageID`
共享包 ID。属于 Plan 且未透支时返回。
**PlanUsedSharedPackageQuota** `boolean` | 是否使用共享包额度
`Records.PlanUsedSharedPackageQuota`
是否使用共享包额度。属于 Plan 且未透支时返回，可能返回 `false`。
**RequestID** `string` | 请求 ID
`Records.RequestID`
同步推理请求 ID。有记录时返回。
**SessionID** `string` | 会话 ID
`Records.SessionID`
会话 ID。非空时返回。
**Timestamp** `integer` | 请求上报时间
`Records.Timestamp`
请求上报时间，Unix 时间戳，单位为秒。有记录时返回。
**UserID** `integer` | 调用身份 ID
`Records.UserID`
调用身份 ID。有记录时返回。
## 代码示例
## 默认
### cURL
#### Request
```bash
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceRequestUsage&Version=2024-01-01' \
-H 'Content-Type: application/json' \
-H 'X-Date: ' \
-H 'X-Content-Sha256: ' \
-H 'Authorization: HMAC-SHA256 Credential=//cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=' \
-d '{
"QueryHour": "2026-09-01 10:00:00",
"RequestID": "request-id-example"
}
'
```
#### Response
```
{
"ResponseMetadata": {
"RequestId": "query-request-id-example",
"Action": "GetInferenceRequestUsage",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"Records": [
{
"AccountID": 1000000001,
"UserID": 10001,
"RequestID": "request-id-example",
"Timestamp": 1788228135,
"APIKeyID": "apikey-example",
"ModelName": "model-example",
"ModelVersion": "version-example",
"ModelEndpoint": "ep-example",
"DeploymentType": "standard",
"BillingStatus": "normal",
"AccountantStartTime": 1788228000,
"AccountantEndTime": 1788228300,
"InputTokens": 100,
"OutputTokens": 20,
"CacheHitTokens": 0,
"AudioTokens": 0,
"AudioCachedTokens": 0
},
{
"AccountID": 1000000001,
"UserID": 10001,
"RequestID": "request-id-example",
"Timestamp": 1788228135,
"APIKeyID": "apikey-example",
"ModelName": "model-example",
"ModelVersion": "version-example",
"ModelEndpoint": "ep-example",
"DeploymentType": "standard",
"BillingStatus": "normal",
"AccountantStartTime": 1788228000,
"AccountantEndTime": 1788228300,
"InputTokens": 30,
"OutputTokens": 10,
"CacheHitTokens": 0,
"AudioTokens": 0,
"AudioCachedTokens": 0
}
]
}
}
```