火山方舟
火山方舟
API参考
请输入
- 文档首页
火山方舟管控面 API管理模型用量查询异步任务用量
复制全文
下载 pdf查询异步任务用量
文档反馈
问问助手POST https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceTaskUsage&Version=2024-01-01
根据 TaskID 查询当前账号下指定异步任务的用量。
鉴权
- 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。有记录时返回。
默认
Request
cURL
curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetInferenceTaskUsage&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 '{
"TaskID": "cgt-example"
}
'Response
{
"ResponseMetadata": {
"RequestId": "query-task-request-id-example",
"Action": "GetInferenceTaskUsage",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"AccountID": 1000000001,
"UserID": 10001,
"TaskID": "cgt-example",
"APIKeyID": "apikey-example",
"AccountantStartTime": 1788228120,
"AccountantEndTime": 1788228150,
"ModelName": "model-example",
"ModelVersion": "version-example",
"ModelEndpoint": "ep-example",
"DeploymentType": "standard",
"Resolution": "480p",
"HasInputVideo": false,
"BillingStatus": "normal",
"OutputTokens": 50638
}
}最近更新时间：2026.10.13 17:40:10
这个页面对您有帮助吗？
有用
有用
无用
无用