`POST https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceRequestUsage&Version=2024-01-01` 根据 `RequestID` 查询指定小时内当前账号下某个同步推理请求的用量明细。 ## 鉴权本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](https://ark.volcengine.com/region:cn-beijing/docs/ark/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。有记录时返回。

火山方舟