文档中心

火山方舟

管理模型用量

查询单请求用量

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 必选 | 查询小时

RequestID string 必选 | 请求 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。有记录时返回。

Records object[] | 用量明细

默认

Request

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

最近更新时间：2026.10.13 17:40:10

这个页面对您有帮助吗？

有用

无用