POST https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceRequestUsage&Version=2024-01-01
根据 RequestID 查询指定小时内当前账号下某个同步推理请求的用量明细。
鉴权#
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。
- Access Key 鉴权，请在 Access Key 管理 页面，获取 Access Key。本接口仅支持 Access Key 鉴权。
请求参数#
Body 参数#
QueryHour string 必选 | 查询小时
请求记录所在小时的起始时间，格式为 YYYY-MM-DD HH:00:00。分钟和秒必须为 00。默认使用北京时间（Asia/Shanghai）；其他环境以其查询时区配置为准。
RequestID string 必选 | 请求 ID
待查询的同步推理请求 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。有记录时返回。