面向 AI 助手:本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/get-inference-task-usage-api.md,全部文档索引见 https://ark.volcengine.com/llms.txt。

查询异步任务用量

POST https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceTaskUsage&Version=2024-01-01

根据 TaskID 查询当前账号下指定异步任务的用量。

鉴权#

本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。

  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。

请求参数#

Body 参数#

TaskID string 必选  |  任务 ID

待查询的异步任务 ID,不能为空或全空白。

响应参数#

AccountantEndTime integer  |  账期结束时间

账期结束时间,Unix 时间戳,单位为秒,不包含该时间点。仅当 BillingStatus 严格等于 normal 时返回。

AccountantStartTime integer  |  账期开始时间

账期开始时间,Unix 时间戳,单位为秒,包含该时间点。仅当 BillingStatus 严格等于 normal 时返回。

AccountID integer  |  账号 ID

记录所属的账号 ID。有记录时返回。

APIKeyID string  |  API Key 标识

任务使用的 API Key 标识,不是 API Key 密钥内容。有记录时返回。

BillingStatus string  |  计费状态

计费状态。有记录时返回。

DeploymentType string  |  部署类型

部署类型。非空时返回。

ErrorCode string  |  错误码

任务错误码。非空时返回。

HasInputVideo boolean  |  是否包含输入视频

是否包含输入视频。有记录时返回,可能返回 false。

ManagedAgentID string  |  托管 Agent ID

托管 Agent ID。非空时返回。

ModelEndpoint string  |  推理接入点 ID

推理接入点 ID。有记录时返回。

ModelName string  |  模型名称

模型名称。有记录时返回。

ModelUnitID string  |  模型单元 ID

模型单元 ID。非空时返回。

ModelVersion string  |  模型版本

模型版本。有记录时返回。

OutputTokens integer  |  输出 Token 数

任务输出 Token 数。有记录时返回,可能返回 0。

PlanChargedAFP string  |  Plan 计费 AFP

Plan 计费值,以十进制字符串保留精度。属于 Plan、未透支且计费值存在时返回。

PlanEdition string  |  Plan 版本

Plan 版本。属于 Plan 且未透支时返回。

PlanIsOverdraft boolean  |  是否透支

是否透支。当前仅在未透支的 Plan 记录中返回,值为 false。

PlanLastestSubscribeMilestone string  |  Plan 订阅里程碑

Plan 订阅里程碑。属于 Plan 且未透支时返回。

PlanPack string  |  Plan 套餐包标识

Plan 套餐包标识。属于 Plan 且未透支时返回。

PlanScene string  |  Plan 场景

Plan 场景。属于 Plan 且未透支时返回。

PlanSeatID string  |  Plan 席位 ID

Plan 席位 ID。属于 Plan 且未透支时返回。

PlanSharedPackageID string  |  共享包 ID

共享包 ID。属于 Plan 且未透支时返回。

PlanUsedSharedPackageQuota boolean  |  是否使用共享包额度

是否使用共享包额度。属于 Plan 且未透支时返回。

Resolution string  |  输出分辨率

任务输出分辨率,例如 480p、720p。有记录时返回。

SessionID string  |  会话 ID

会话 ID。非空时返回。

TaskID string  |  任务 ID

异步任务 ID。有记录时返回。

UserID integer  |  调用身份 ID

调用身份 ID。有记录时返回。