arkcli usage
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、配置排查与共享安全规则
CRITICAL — usage stats 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-stats.md,禁止直接盲目调用命令。
CRITICAL — usage plan 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-plan.md,禁止直接盲目调用命令。
CRITICAL — usage plan-details 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-plan-details.md,禁止直接盲目调用命令。
CRITICAL — usage balance 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-balance.md,禁止直接盲目调用命令。
CRITICAL — usage seats 在执行之前,务必先用 Read 工具读取 references/arkcli-usage-seats.md,禁止直接盲目调用命令。
数据时效(务必先看):usage stats 走的是上游 BFF 的聚合管道,数据有 5–30 分钟延迟,定位为「日级 / 聚合分析」。 不要把它用于实时预算监控、限流、实时告警等需要秒级精度的控制场景——这类场景请直接读 +chat / +gen 等推理命令返回里的 .usage 字段(per-request、零延迟,详见 arkcli-chat 与 arkcli-gen)。
语音模型边界:TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互,或 doubao-seed-tts-* / doubao-seed-asr-* / seedasr-* 等广场语音模型,当前在 arkcli 只支持 models search 发现。不要用 usage stats --model、usage plan-details 或套餐/余额命令回答语音模型用量;直接说明 arkcli 不支持查询语音模型费用或用量。
stats / plan / plan-details / balance 区分:
stats 出"按 token 计费的 inference 用量"(任何身份,5–30 分钟延迟)
plan 出"订阅套餐的 quota 快照"(AgentPlan / CodingPlan 个人版 + 团队版的"我用了几成 / 几号刷新")
plan-details 出"AgentPlan 按模型 / 套餐内外的时间序列调用明细"(AgentPlan 个人版 + 团队版,CodingPlan 没有按模型 endpoint)
balance 出"还剩多少 X"(余额视角,--type free-quota / media-asset / plan 三选一)
seats 出"团队席位用量 admin 视角"(每个 seat 用了多少 / 套餐百分比;只是用量视图)。席位的列表 / 绑定 / 分配 / API Key 轮换 走 arkcli-plans 的 plans team seat-list / seat-assign / rotate-apikey。
用户问「我的套餐还剩多少额度」→ plan 或 balance --type plan(后者输出更精简);「我哪个模型用得最多」→ plan-details;「我今天用了多少 token」→ stats;「我还剩多少免费额度 / 媒资库容量」→ balance;「每个 seat 用了多少 / 团队席位用量分布」→ seats --with-usage(纯管理类:谁绑了哪个 seat / 列出席位 / 分配席位 / 轮换 key → arkcli-plans)。
Step 0(MUST):查"我的用量"先按 profile 路由
所有"我的用量 / 我用了多少 token / 我的消耗"类问题,跑任何 usage 命令前必须先走这三步。 否则会把"我的用量"等同于"我的 endpoint 用量",漏掉套餐 quota 桶 —— agent-plan 用户的主消耗就在套餐里,直接 usage stats --mine 经常 data_count=0 或严重不全。
核心原则:先查"自己这档 profile 的套餐桶",再查 endpoint 桶。 profile.type 决定"自己这档"是什么,模态决定"该模态在不在套餐覆盖内"。
- 探 profile.type:
arkcli profile show --format json,读 type(platform / agent-plan / agent-plan-team / coding-plan / coding-plan-team)
- 定模态:用户点名模型/模态 → 只查该模态;没点名 → 全模态都覆盖(text / image / video 各按表走一遍)
- 按 (type × modality) 路由(
①→② = 先套餐桶、再 endpoint 桶;单格 = 只查 endpoint 桶):
| profile.type |
text 模型 |
image 模型 |
video 模型 |
agent-plan / agent-plan-team |
① arkcli usage plan(+arkcli usage plan-details --start <YYYY-MM-DD>)② arkcli usage stats --start <YYYY-MM-DD> --mine |
① arkcli usage plan② arkcli usage stats --start <YYYY-MM-DD> --mine |
① arkcli usage plan② arkcli usage stats --start <YYYY-MM-DD> --mine |
coding-plan / coding-plan-team |
① arkcli usage plan② arkcli usage stats --start <YYYY-MM-DD> --mine |
arkcli usage stats --start <YYYY-MM-DD> --mine(套餐不覆盖) |
arkcli usage stats --start <YYYY-MM-DD> --mine(套餐不覆盖) |
platform |
arkcli usage stats --start <YYYY-MM-DD> --mine(无套餐) |
arkcli usage stats --start <YYYY-MM-DD> --mine |
arkcli usage stats --start <YYYY-MM-DD> --mine |
日期参数(必读):表中 <YYYY-MM-DD> 换成实际日期 —— usage stats / usage plan-details 必带 --start(缺失 CLI 报 required flag(s) "start" not set,不会默认今天);usage stats 的 --end 缺省=今天。从自然语言推导 --start:"今天"→ --start=今天;"昨天"→ 昨天;"近 N 天 / 最近一周"→ 今天-(N-1);"本月/上月"→ 填月初到月末区间;用户未指明任何时间词 → 默认 --start=今天、--end 缺省同今天。usage plan / usage balance 无需日期。本 skill 其它处把命令简写(不带 arkcli 前缀、或省略 --start)时,执行前一并补全。
为什么这么分: Agent Plan 套餐自带生文 + 生图 + 生视频预置模型 → 三模态主消耗都在套餐;Coding Plan 套餐只自带生文 → 文本看套餐、图/视频借道 platform endpoint 池只能看 endpoint;Platform 无套餐 → 全走 endpoint 按量。
Step 0 边界:
- 套餐未订阅(
usage plan 返 subscribed:false)→ 套餐桶为空,自然落到 usage stats --mine,不报错
- CodingPlan 的
usage plan-details(按模型时序)后端不支持(见 references/arkcli-usage-plan-details.md);coding-plan 文本桶只能 usage plan 看 quota 百分比,不能按模型拆
- endpoint 桶查法、撞空 fallback(endpoint→apikey)见下方「快速决策」与
references/arkcli-usage-stats.md
适用场景
- 查看当日或指定日期范围的推理用量(接受 5–30 分钟延迟)
- 看订阅套餐(AgentPlan / CodingPlan)的配额消耗 / 重置时间
- 看 AgentPlan 套餐内 vs 套餐外的按模型拆分明细
- 按模型、接入点、API Key 维度分组统计(stats)
- 分析 Token 消耗趋势、出对账报表
- 不适用于语音模型用量:用户问 TTS / ASR / 语音模型用了多少、剩余额度、调用次数时,不执行本 skill,转
arkcli-models 说明只支持广场发现
业务定位
- 本 skill 对应"看存量调用结果和消耗"的场景,是离线 / 准实时分析入口
- 它通常发生在两类后置链路之后:
- Endpoint 已经存在,想按 endpoint 看使用情况
- 模型已经在被调用,想按 model / API Key 分析消耗
- 或:订阅了套餐,想看额度还剩多少
- 它不是创建 Endpoint 的入口,也不是试用模型的入口
- 它不是实时预算 / 限流 / 告警的数据源——实时控制请走 per-request
.usage 字段(见上方 banner)
快速决策
- 用户问"我的套餐还剩多少 / 用了几成 / 几号刷新 / 我有几个套餐":
arkcli usage plan(默认探所有 4 个 SKU:personal × 2 + team × 2,subscribed 桶才下发 usage 请求)
arkcli usage plan --all:不探订阅,4 桶全跑(诊断 / Excel)
arkcli usage plan --product=X:跳过探测,单查
- 跟
balance --type plan 是同一份数据;usage plan 输出完整(带 subscribed / updated_at),balance --type plan 精简(去掉元字段)。一般默认走 usage plan,只有用户明确把套餐余额跟"免费额度 / 媒资库容量"一起对账时,才走 balance --type plan(三 type 一起跑节省心智)
- 用户问"我哪个模型用得最多 / 套餐内套餐外各占多少 / 团队某个子用户用得多":
arkcli usage plan-details(默认近 7 天 Day 粒度,AgentPlan personal)
arkcli usage plan-details --product=agent-plan-team(团队版,自动找 caller seat 或显式 --seat <id>)
- 用户问"我的用量 / 我今天用了多少 token / 我的 endpoint 消耗":
- 先过 Step 0(本文档顶部)定 profile.type + 模态:agent-plan / coding-plan(text 模态)要先查套餐桶(
usage plan;agent-plan 再加 usage plan-details),再做下面的 endpoint 桶;platform、或 coding-plan 的 image/video 模态直接进 endpoint 桶 —— 别把"我的用量"等同于"我的 endpoint 用量"
- 如果用户点名的是语音模型或 TTS / ASR 场景 → 不要继续查 usage;当前 arkcli 只承认语音模型广场发现,不支持语音模型用量查询
- 火山: 先
arkcli usage stats --start <YYYY-MM-DD> --mine(默认 endpoint 维度)
- 返回
data_count > 0 → 直接从 totals 取合计
- 返回
data_count=0(用户没有 Endpoint 或近期未通过 Endpoint 调用)→ 立即重试 arkcli usage stats --start <YYYY-MM-DD> --mine --mine-by=apikey
- ⛔ 禁止退化为不带
--mine 的全量查询 —— 全账号数据(data_count 极大)≠ "我的用量";必须始终保持 --mine 范围
- 用户问"我每个 APIKey 用了多少":
- 火山:
arkcli usage stats --start <YYYY-MM-DD> --mine --mine-by=apikey,从 records[].AuthToken 拆分
- 用户问"我账上还有多少免费 token / 模型免费额度 / 媒资库还能存多少":
arkcli usage balance --type free-quota(模型免费推理额度)
arkcli usage balance --type media-asset(素材库容量)
- 用户问"团队席位用了多少 / 每个 seat 消耗 / 套餐百分比 by seat"(admin 用量视角):
arkcli usage seats --product agent-plan-team --with-usage(列席位 + 每个 seat 的 AFP 用量)
- 不带
--with-usage 也行,但只有基础元数据,没有用量数字
- 路由分工:本命令只回答"用量",不负责 seat 管理。"列席位 / 谁绑了哪个 seat / 给员工分配席位 / 轮换席位 APIKey" 全部走
arkcli-plans 的 plans team seat-list / seat-assign / rotate-apikey。Agent 路由这条问句先看动词:"用了 / 消耗 / 多少" 留这边,"绑 / 列 / 分 / 轮换" 跳过去 plans。
- 数据看起来不对:先查认证和 profile,再怀疑数据本身
Agent 快速执行顺序
- 先确认认证状态;不确定时先看
arkcli auth status
- 先做最小查询,再逐步加时间范围和分组条件
- 结果异常时,先检查 profile / region / API Key 来源是否正确,再怀疑数据本身
- 如果用户要按 endpoint 看 usage,最好先确认 endpoint-id 已知
常见降级
命令一览
| 命令 |
说明 |
usage stats |
查询推理用量(Token / 请求数,按日 / 小时聚合,按 token 计费的 inference 视角) |
usage plan |
查询订阅套餐的额度快照(AgentPlan / CodingPlan,5h / weekly / monthly / session 周期的"用了多少 / 还剩多少 / 几号刷新")。默认探所有 4 个 SKU |
usage plan-details |
查询 AgentPlan 个人版 + 团队版 按模型 / Harness 的时间序列调用明细(套餐内 vs 套餐外拆分)。默认近 7 天,--product=agent-plan-team 切团队版 |
usage balance |
余额视角统一入口 --type free-quota / media-asset / plan(模型免费推理额度 / 素材库容量 / 套餐余额) |
usage seats |
Admin 视角 列举企业版套餐下所有席位(SeatID / 绑定子用户 / billing 状态)。子用户调通常 AccessDenied |
自然语言触发词表
| 用户怎么说 |
对应命令 |
| "按模型明细 / 哪个模型用得最多 / 模型维度拆分 / 按模型时序 / 套餐内套餐外按模型" |
arkcli usage plan-details |
| "coding plan 按模型明细 / coding plan 套餐内套餐外" |
arkcli usage plan-details --product=coding-plan-personal |
| "配额还剩多少 / 余额 / 还能用多少 / 用了几成 / 套餐额度" |
arkcli usage plan 或 arkcli usage balance --type plan |
| "免费额度还有多少 / 模型免费额度 / 免费 token" |
arkcli usage balance --type free-quota |
| "AFP 消耗 / 今日 AFP / 本周 AFP" |
arkcli usage plan(AFP 就是套餐额度单位) |
| "我的用量 / 我今天用了多少 token / 推理用量 / token 消耗" |
arkcli usage stats --start <YYYY-MM-DD> --mine |
参考
1---2name: arkcli-usage3version: 1.3.24description: "ARK 用量查询:`usage stats`(Token / 请求数,5-30 分钟延迟)、`usage plan` / `usage balance --type plan`(套餐额度快照)、`usage plan-details`(按模型时间序列,套餐内/外拆分)、`usage balance`(余额:免费额度 / 媒资库 / 套餐)、`usage seats --with-usage`(团队席位用量 by seat)。命中关键词:用量 / 用了多少 / 还剩多少额度 / 套餐用了几成 / 套餐内套餐外 / 每个 seat 消耗。**席位的列表 / 绑定 / 分配 / 轮换 APIKey 属管理范畴,走 arkcli-plans;本 skill 只回答用量。**动词路由:**用 / 消耗 / 多少** → 这里;**列 / 绑 / 分 / 轮换** → arkcli-plans。反触发:TTS/ASR/语音模型用量不支持查询,只能转 models search 说明广场发现边界。"5metadata:6 source: https://skillmd.com/skills/openclaw-cn-dev/arkcli-usage7 requires:8 bins: ["arkcli"]9 cliHelp: "arkcli usage stats --help"10---1112# arkcli usage1314**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../arkcli-shared/SKILL.md`](../arkcli-shared/SKILL.md),其中包含认证闸门、配置排查与共享安全规则**15**CRITICAL — `usage stats` 在执行之前,务必先用 Read 工具读取 [`references/arkcli-usage-stats.md`](references/arkcli-usage-stats.md),禁止直接盲目调用命令。**16**CRITICAL — `usage plan` 在执行之前,务必先用 Read 工具读取 [`references/arkcli-usage-plan.md`](references/arkcli-usage-plan.md),禁止直接盲目调用命令。**17**CRITICAL — `usage plan-details` 在执行之前,务必先用 Read 工具读取 [`references/arkcli-usage-plan-details.md`](references/arkcli-usage-plan-details.md),禁止直接盲目调用命令。**18**CRITICAL — `usage balance` 在执行之前,务必先用 Read 工具读取 [`references/arkcli-usage-balance.md`](references/arkcli-usage-balance.md),禁止直接盲目调用命令。**19**CRITICAL — `usage seats` 在执行之前,务必先用 Read 工具读取 [`references/arkcli-usage-seats.md`](references/arkcli-usage-seats.md),禁止直接盲目调用命令。**2021> **数据时效(务必先看):`usage stats` 走的是上游 BFF 的聚合管道,数据有 5–30 分钟延迟,定位为「日级 / 聚合分析」。** 不要把它用于实时预算监控、限流、实时告警等需要秒级精度的控制场景——这类场景请直接读 `+chat` / `+gen` 等推理命令返回里的 `.usage` 字段(per-request、零延迟,详见 [arkcli-chat](../arkcli-chat/SKILL.md) 与 [arkcli-gen](../arkcli-gen/SKILL.md))。2223> **语音模型边界**:TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互,或 `doubao-seed-tts-*` / `doubao-seed-asr-*` / `seedasr-*` 等广场语音模型,当前在 arkcli 只支持 `models search` 发现。不要用 `usage stats --model`、`usage plan-details` 或套餐/余额命令回答语音模型用量;直接说明 arkcli 不支持查询语音模型费用或用量。2425> **stats / plan / plan-details / balance 区分:**26> - `stats` 出"按 token 计费的 inference 用量"(任何身份,5–30 分钟延迟)27> - `plan` 出"订阅套餐的 quota 快照"(AgentPlan / CodingPlan 个人版 + 团队版的"我用了几成 / 几号刷新")28> - `plan-details` 出"AgentPlan 按模型 / 套餐内外的时间序列调用明细"(AgentPlan 个人版 + 团队版,CodingPlan 没有按模型 endpoint)29> - `balance` 出"还剩多少 X"(余额视角,`--type free-quota / media-asset / plan` 三选一)30> - `seats` 出"团队席位**用量** admin 视角"(每个 seat 用了多少 / 套餐百分比;**只是用量视图**)。**席位的列表 / 绑定 / 分配 / API Key 轮换** 走 [`arkcli-plans`](../arkcli-plans/SKILL.md) 的 `plans team seat-list / seat-assign / rotate-apikey`。31>32> 用户问「我的套餐还剩多少额度」→ `plan` 或 `balance --type plan`(后者输出更精简);「我哪个模型用得最多」→ `plan-details`;「我今天用了多少 token」→ `stats`;「我还剩多少免费额度 / 媒资库容量」→ `balance`;「**每个 seat 用了多少 / 团队席位用量分布**」→ `seats --with-usage`(纯管理类:谁绑了哪个 seat / 列出席位 / 分配席位 / 轮换 key → `arkcli-plans`)。3334## Step 0(MUST):查"我的用量"先按 profile 路由3536**所有"我的用量 / 我用了多少 token / 我的消耗"类问题,跑任何 `usage` 命令前必须先走这三步。** 否则会把"我的用量"等同于"我的 endpoint 用量",漏掉套餐 quota 桶 —— agent-plan 用户的主消耗就在套餐里,直接 `usage stats --mine` 经常 `data_count=0` 或严重不全。3738**核心原则:先查"自己这档 profile 的套餐桶",再查 endpoint 桶。** `profile.type` 决定"自己这档"是什么,模态决定"该模态在不在套餐覆盖内"。39401. **探 profile.type**:`arkcli profile show --format json`,读 `type`(`platform` / `agent-plan` / `agent-plan-team` / `coding-plan` / `coding-plan-team`)412. **定模态**:用户点名模型/模态 → 只查该模态;没点名 → 全模态都覆盖(text / image / video 各按表走一遍)423. **按 (type × modality) 路由**(`①→②` = 先套餐桶、再 endpoint 桶;单格 = 只查 endpoint 桶):4344| profile.type | text 模型 | image 模型 | video 模型 |45|---|---|---|---|46| `agent-plan` / `agent-plan-team` | ① `arkcli usage plan`(+`arkcli usage plan-details --start <YYYY-MM-DD>`)<br>② `arkcli usage stats --start <YYYY-MM-DD> --mine` | ① `arkcli usage plan`<br>② `arkcli usage stats --start <YYYY-MM-DD> --mine` | ① `arkcli usage plan`<br>② `arkcli usage stats --start <YYYY-MM-DD> --mine` |47| `coding-plan` / `coding-plan-team` | ① `arkcli usage plan`<br>② `arkcli usage stats --start <YYYY-MM-DD> --mine` | `arkcli usage stats --start <YYYY-MM-DD> --mine`<br>(套餐不覆盖) | `arkcli usage stats --start <YYYY-MM-DD> --mine`<br>(套餐不覆盖) |48| `platform` | `arkcli usage stats --start <YYYY-MM-DD> --mine`<br>(无套餐) | `arkcli usage stats --start <YYYY-MM-DD> --mine` | `arkcli usage stats --start <YYYY-MM-DD> --mine` |4950> **日期参数(必读)**:表中 `<YYYY-MM-DD>` 换成实际日期 —— `usage stats` / `usage plan-details` **必带 `--start`**(缺失 CLI 报 `required flag(s) "start" not set`,**不会**默认今天);`usage stats` 的 `--end` 缺省=今天。**从自然语言推导 `--start`**:"今天"→ `--start`=今天;"昨天"→ 昨天;"近 N 天 / 最近一周"→ 今天-(N-1);"本月/上月"→ 填月初到月末区间;**用户未指明任何时间词 → 默认 `--start`=今天、`--end` 缺省同今天**。`usage plan` / `usage balance` 无需日期。本 skill 其它处把命令简写(不带 `arkcli` 前缀、或省略 `--start`)时,执行前一并补全。5152**为什么这么分:** Agent Plan 套餐自带生文 + 生图 + 生视频预置模型 → 三模态主消耗都在套餐;Coding Plan 套餐只自带生文 → 文本看套餐、图/视频借道 platform endpoint 池只能看 endpoint;Platform 无套餐 → 全走 endpoint 按量。5354**Step 0 边界:**55- 套餐未订阅(`usage plan` 返 `subscribed:false`)→ 套餐桶为空,自然落到 `usage stats --mine`,不报错56- CodingPlan 的 `usage plan-details`(按模型时序)后端不支持(见 [`references/arkcli-usage-plan-details.md`](references/arkcli-usage-plan-details.md));coding-plan 文本桶只能 `usage plan` 看 quota 百分比,不能按模型拆57- endpoint 桶查法、撞空 fallback(endpoint→apikey)见下方「快速决策」与 [`references/arkcli-usage-stats.md`](references/arkcli-usage-stats.md)5859## 适用场景6061- 查看当日或指定日期范围的推理用量(**接受 5–30 分钟延迟**)62- 看订阅套餐(AgentPlan / CodingPlan)的配额消耗 / 重置时间63- 看 AgentPlan 套餐内 vs 套餐外的按模型拆分明细64- 按模型、接入点、API Key 维度分组统计(stats)65- 分析 Token 消耗趋势、出对账报表66- **不适用于语音模型用量**:用户问 TTS / ASR / 语音模型用了多少、剩余额度、调用次数时,不执行本 skill,转 `arkcli-models` 说明只支持广场发现6768## 业务定位6970- 本 skill 对应"看存量调用结果和消耗"的场景,是**离线 / 准实时**分析入口71- 它通常发生在两类后置链路之后:72 - Endpoint 已经存在,想按 endpoint 看使用情况73 - 模型已经在被调用,想按 model / API Key 分析消耗74 - 或:订阅了套餐,想看额度还剩多少75- 它不是创建 Endpoint 的入口,也不是试用模型的入口76- **它不是实时预算 / 限流 / 告警的数据源**——实时控制请走 per-request `.usage` 字段(见上方 banner)7778## 快速决策7980- 用户问"我的套餐还剩多少 / 用了几成 / 几号刷新 / 我有几个套餐":81 - `arkcli usage plan`(默认探所有 4 个 SKU:personal × 2 + team × 2,subscribed 桶才下发 usage 请求)82 - `arkcli usage plan --all`:不探订阅,4 桶全跑(诊断 / Excel)83 - `arkcli usage plan --product=X`:跳过探测,单查84 - **跟 `balance --type plan` 是同一份数据**;`usage plan` 输出完整(带 `subscribed` / `updated_at`),`balance --type plan` 精简(去掉元字段)。一般默认走 `usage plan`,只有用户明确把套餐余额跟"免费额度 / 媒资库容量"一起对账时,才走 `balance --type plan`(三 type 一起跑节省心智)85- 用户问"我哪个模型用得最多 / 套餐内套餐外各占多少 / 团队某个子用户用得多":86 - `arkcli usage plan-details`(默认近 7 天 Day 粒度,AgentPlan personal)87 - `arkcli usage plan-details --product=agent-plan-team`(团队版,自动找 caller seat 或显式 `--seat <id>`)88- 用户问"我的用量 / 我今天用了多少 token / 我的 endpoint 消耗":89 - **先过 Step 0(本文档顶部)定 profile.type + 模态**:agent-plan / coding-plan(text 模态)要**先**查套餐桶(`usage plan`;agent-plan 再加 `usage plan-details`),再做下面的 endpoint 桶;platform、或 coding-plan 的 image/video 模态直接进 endpoint 桶 —— 别把"我的用量"等同于"我的 endpoint 用量"90 - 如果用户点名的是语音模型或 TTS / ASR 场景 → **不要继续查 usage**;当前 arkcli 只承认语音模型广场发现,不支持语音模型用量查询91 - **火山:** 先 `arkcli usage stats --start <YYYY-MM-DD> --mine`(默认 endpoint 维度)92 - 返回 `data_count > 0` → 直接从 `totals` 取合计93 - 返回 `data_count=0`(用户没有 Endpoint 或近期未通过 Endpoint 调用)→ 立即重试 `arkcli usage stats --start <YYYY-MM-DD> --mine --mine-by=apikey`94 - **⛔ 禁止退化为不带 `--mine` 的全量查询** —— 全账号数据(data_count 极大)≠ "我的用量";必须始终保持 `--mine` 范围95- 用户问"我每个 APIKey 用了多少":96 - **火山:** `arkcli usage stats --start <YYYY-MM-DD> --mine --mine-by=apikey`,从 `records[].AuthToken` 拆分97- 用户问"我账上还有多少免费 token / 模型免费额度 / 媒资库还能存多少":98 - `arkcli usage balance --type free-quota`(模型免费推理额度)99 - `arkcli usage balance --type media-asset`(素材库容量)100- 用户问"团队席位**用了多少** / 每个 seat 消耗 / 套餐百分比 by seat"(admin 用量视角):101 - `arkcli usage seats --product agent-plan-team --with-usage`(列席位 + 每个 seat 的 AFP 用量)102 - 不带 `--with-usage` 也行,但只有基础元数据,没有用量数字103 - **路由分工**:本命令**只**回答"用量",不负责 seat 管理。"**列席位 / 谁绑了哪个 seat / 给员工分配席位 / 轮换席位 APIKey**" 全部走 [`arkcli-plans`](../arkcli-plans/SKILL.md) 的 `plans team seat-list / seat-assign / rotate-apikey`。Agent 路由这条问句先看动词:**"用了 / 消耗 / 多少"** 留这边,**"绑 / 列 / 分 / 轮换"** 跳过去 plans。104- 数据看起来不对:先查认证和 profile,再怀疑数据本身105106## Agent 快速执行顺序1071081. 先确认认证状态;不确定时先看 `arkcli auth status`1092. 先做最小查询,再逐步加时间范围和分组条件1103. 结果异常时,先检查 profile / region / API Key 来源是否正确,再怀疑数据本身1114. 如果用户要按 endpoint 看 usage,最好先确认 endpoint-id 已知112113## 常见降级114115- 鉴权错误:转 [`../arkcli-auth/SKILL.md`](../arkcli-auth/SKILL.md)116- 查询范围或环境不对:转 [`../arkcli-config/SKILL.md`](../arkcli-config/SKILL.md)117- 用户其实还没有 Endpoint,只是在准备正式接入:转 [`../arkcli-deploy/SKILL.md`](../arkcli-deploy/SKILL.md)118- 用户想看套餐**价格**(不是用量):转 [`../arkcli-pricing/SKILL.md`](../arkcli-pricing/SKILL.md)(`pricing plans` 出 catalog 询价,`usage plan` 出 quota 快照,两者是不同视角)119- 用户想看**结算金额 / 账单 / 花了多少钱**(不是 token 用量):转 [`../arkcli-billing/SKILL.md`](../arkcli-billing/SKILL.md)(数据源是火山计费中心, T+1 出账; usage stats 是 BFF 推理聚合, 近实时)120- 用户问语音模型 / TTS / ASR 的用量或额度:转 [`../arkcli-models/SKILL.md`](../arkcli-models/SKILL.md) 只说明广场可搜与 arkcli 不支持用量查询,不转 pricing / billing121122## 命令一览123124| 命令 | 说明 |125|------|------|126| [`usage stats`](references/arkcli-usage-stats.md) | 查询推理用量(Token / 请求数,按日 / 小时聚合,按 token 计费的 inference 视角) |127| [`usage plan`](references/arkcli-usage-plan.md) | 查询订阅套餐的额度快照(AgentPlan / CodingPlan,5h / weekly / monthly / session 周期的"用了多少 / 还剩多少 / 几号刷新")。默认探所有 4 个 SKU |128| [`usage plan-details`](references/arkcli-usage-plan-details.md) | 查询 AgentPlan **个人版 + 团队版** 按模型 / Harness 的时间序列调用明细(套餐内 vs 套餐外拆分)。默认近 7 天,`--product=agent-plan-team` 切团队版 |129| [`usage balance`](references/arkcli-usage-balance.md) | 余额视角统一入口 `--type free-quota / media-asset / plan`(模型免费推理额度 / 素材库容量 / 套餐余额) |130| [`usage seats`](references/arkcli-usage-seats.md) | **Admin 视角** 列举企业版套餐下所有席位(SeatID / 绑定子用户 / billing 状态)。子用户调通常 AccessDenied |131132## 自然语言触发词表133134| 用户怎么说 | 对应命令 |135|---|---|136| "按模型明细 / 哪个模型用得最多 / 模型维度拆分 / 按模型时序 / 套餐内套餐外按模型" | `arkcli usage plan-details` |137| "coding plan 按模型明细 / coding plan 套餐内套餐外" | `arkcli usage plan-details --product=coding-plan-personal` |138| "配额还剩多少 / 余额 / 还能用多少 / 用了几成 / 套餐额度" | `arkcli usage plan` 或 `arkcli usage balance --type plan` |139| "免费额度还有多少 / 模型免费额度 / 免费 token" | `arkcli usage balance --type free-quota` |140| "AFP 消耗 / 今日 AFP / 本周 AFP" | `arkcli usage plan`(AFP 就是套餐额度单位) |141| "我的用量 / 我今天用了多少 token / 推理用量 / token 消耗" | `arkcli usage stats --start <YYYY-MM-DD> --mine` |142143## 参考144145- [arkcli-deploy](../arkcli-deploy/SKILL.md) -- 先创建 Endpoint,再按 endpoint 看 usage146- [arkcli-pricing](../arkcli-pricing/SKILL.md) -- catalog 询价(`pricing plans`),跟 `usage plan` quota 快照互补147- [arkcli-shared](../arkcli-shared/SKILL.md) -- 认证和全局参数