SuperAPI AI 工具集

arkcli-billing

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:查询火山引擎 ARK 拆分账单明细,输出结算金额与 Token 用量计费,支持按账期月或月范围、Endpoint、API Key、产品编码、账单类型过滤,用于月度/季度/年度对账及排查某 EP 或某 Key 的花费。

与 usage stats 的区别:billing 数据来自火山计费中心拆账,T+1 出账,单位为 CNY 金额;usage stats 来自 ARK BFF 推理聚合,延迟 5–30 分钟,单位为 Token/请求数。想看用量用 arkcli-usage,想看花费用本技能。

使用方式:执行前须读取 ../arkcli-shared/SKILL.md(认证与全局规则)和 references/arkcli-billing-list.md(参数详解)。每条 billing list 必带 --start <YYYY-MM>,查多月范围再加 --end <YYYY-MM>(闭区间,最多 24 个月)。常用命令:arkcli billing list --start 2026-05 --mine(查自己花费);--endpoint ep-... 或 --apikey ark-... 查单个资源;--split-dim endpoint|apikey 做服务端聚合;--interval day 配 --day YYYY-MM-DD 或 --interval detail 看明细;--product ark_subscription 查订阅类账单(默认 scope 不含)。

路由规则:查“我的账单”前先探 profile.type(arkcli auth whoami --format json)。agent-plan / coding-plan 类先查套餐账单(--product ark_subscription),再查 endpoint 账单(--mine);platform 无套餐直接 --mine。--mine 撞空时自动重试 --mine --mine-by=apikey,仍空则报告零资源,禁止退化为不带 --mine 的全量查询。

限制与纪律:is_truncated=true 时须停下询问用户,不要自动决策;不要 sum items 当总额;金额是 CNY 字符串,加和比较用 decimal 库;月初对账应拉前一个完整账期;--mine 按 IAM 子用户过滤资源,不等于 PayerID;默认 scope 为 ARK 推理及 9 个支持 API Key 分账的产品,profile.project 会自动注入过滤,强制账号全量传 --project=。鉴权问题见 arkcli-auth,价格目录见 arkcli-pricing。