菜单
查询火山引擎 ARK 拆分账单明细（结算金额、Token 用量计费），支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同：stats 出推理量（近实时），billing 出结算金额（T+1 出账，财务口径）。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/volcengine/ark-cli --skill arkcli-billing命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
使用 ArkCLI 创建、校验、查询、更新、删除、版本化和下载 Dataset。用户提到 Dataset、数据集、ds-*、dsv-*、训练集/验证集复用、数据格式校验或把 Dataset 接入精调任务时使用。
使用 ArkCLI 创建、查询和管理模型精调训练任务，并从训练指标选择最佳 step、导出训练产物为 custom model、衔接模型仓库与推理部署。任何包含精调任务 ID（`mcj-*`）的查询、查不到原因诊断、日志、trajectory、状态或生命周期操作都应使用本 skill；也适用于选择训练方法、查询精调价格和超参数、创建任务及导出部署。本 skill 不负责数据集管理。
arkcli helper：为 Claude Code / Codex / OpenCode / OpenClaw / Hermes 配置火山方舟 Plan 或 Platform Endpoint 的 model/provider，或给支持的 Agent（含 MCP-only Trae）配置 Harness 工具。真人 TTY 运行 `arkcli helper` 可选择模型和 Harness 能力；`helper mcp` 默认保持整组 Agent Plan MCP 行为，传 `--capability datapro|web-search|agent-memory` 只配单项，传 `--capability cua` 只给目标 Agent 安装云电脑 Skill；连 model/provider 一起配置用 `helper configure`，查状态用 `helper list`，移除用 `helper reset`。Agent Plan / Team 还支持专业数据集、豆包搜索、Agent 记忆、AI Native 应用开发底座、Agent 进化与 routing.v1 强制检索路由；上下文出现 ARKCLI ROUTING ENFORCEMENT / routing.v1，或用户要求在豆包搜索、DataPro、OpenViking、Supabase 之间强制分流时也使用本 Skill：调用这四类受管 Provider 前先提交 Route Plan，再调用唯一授权 Provider；原生 WebSearch/WebFetch/WebExtract 位于路由管理范围之外。Platform 只允许本人创建、Running、已验证为文本输出的 Endpoint，不配置 MCP、Supabase 或强制路由。豆包搜索配置成功后默认关闭目标客户端原生 WebSearch；传 `--keep-native-websearch` 可保留，并可用 `helper reset` 完整恢复 ArkCLI 配置。
基于 SOC 职业分类
| name | arkcli-billing |
| version | 1.1.1 |
| description | 查询火山引擎 ARK 拆分账单明细（结算金额、Token 用量计费），支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同：stats 出推理量（近实时），billing 出结算金额（T+1 出账，财务口径）。 |
| metadata | {"requires":{"bins":["arkcli"]},"cliHelp":"arkcli billing list --help"} |
执行前 MUST 读取 ../arkcli-shared/SKILL.md (认证 / 全局规则) 和 references/arkcli-billing-list.md (参数详解)。
| 维度 | usage stats | billing list |
|---|---|---|
| 数据源 | ARK BFF 推理聚合 | 火山计费中心拆账 |
| 时效 | 5–30 分钟延迟 | T+1 出账 |
| 单位 | Token / 请求数 | CNY 金额 |
想看"用了多少 token"→ arkcli-usage;想看"花了多少钱"→ 本 skill。
跟 arkcli-usage 的 Step 0(canonical 原则)同一套 —— 先查"自己这档 profile 的套餐账单",再查 endpoint 账单。查任何"我…花了多少"前必走:
arkcli profile show --format json,读 type①→② = 先套餐账单、再 endpoint 账单;单格 = 只查 endpoint 账单):| profile.type | text | image / video |
|---|---|---|
agent-plan / agent-plan-team | ① arkcli billing list --start <YYYY-MM> --product ark_subscription② arkcli billing list --start <YYYY-MM> --mine | 同 text(全模态都先套餐、再 endpoint) |
coding-plan / coding-plan-team | ① arkcli billing list --start <YYYY-MM> --product ark_subscription② arkcli billing list --start <YYYY-MM> --mine | arkcli billing list --start <YYYY-MM> --mine(套餐不覆盖) |
platform | arkcli billing list --start <YYYY-MM> --mine(无套餐) | arkcli billing list --start <YYYY-MM> --mine |
依据同 usage:Agent Plan 套餐覆盖三模态、Coding Plan 套餐只覆盖文本、Platform 无套餐。套餐账单走订阅类必须显式 --product ark_subscription(默认 scope 不含订阅,见下方「Agent 关键纪律」);endpoint 账单 --mine 的撞空 fallback 见下。每条 billing list 必带 --start <YYYY-MM>(月单位,缺省即报 --start is required;查多月范围再加 --end <YYYY-MM>)。
| 用户问 | 命令 |
|---|---|
| 我这个月 / 上个月花了多少 (含"我"语义) | 先过 Step 0(本文档顶部):plan profile(agent / coding-text)先 arkcli billing list --start <YYYY-MM> --product ark_subscription 套餐账单、再 arkcli billing list --start <YYYY-MM> --mine endpoint 账单;platform 或非覆盖模态直接 arkcli billing list --start 2026-05 --mine — 撞空有 fallback 流程见下 |
| 整个账号花了多少 / 公司账号 / 整体 (无主语自指) | arkcli billing list --start 2026-05 (账号维度全量) |
| 这个 EP 花了多少 | arkcli billing list --start 2026-05 --endpoint ep-... |
| 这把 key 花了多少 | arkcli billing list --start 2026-05 --apikey ark-... |
| 账号下每个 EP / key 各花了多少 | --split-dim endpoint 或 --split-dim apikey |
| 按天 / 按每条结算明细 | --interval day 配 --day YYYY-MM-DD,或 --interval detail |
| 过去 N 个月对账 | --start ... --end ... (闭区间, 最多 24 个月) |
| 看 Agent Plan / Coding Plan 订阅类账单 | 显式 --product ark_subscription (默认查询不含) |
--mine fallback 流程 (跟 usage stats 对齐)用户问"我...花了多少"时:
arkcli billing list --start <YYYY-MM> --mine(默认 --mine-by=endpoint)
partial_failures 检查截断后,告诉用户金额合计no endpoints owned by current sub-user) → 立即重试 --mine --mine-by=apikey--mine 的全量查询 — 全账号金额 ≠ "我花的",一旦丢 --mine 范围语义就跑偏(对齐 arkcli-usage 的同条款)dim 间 fallback (endpoint→apikey) agent 可以自动重试,因为同 mine 语义、不改查询范围;但不能丢 --mine 退到全量(那是改语义)。
is_truncated=true 时停下问用户,不要自动决策 — 撞 cap (preflight 模式下 items 不返,只有 metadata + partial_failures + stderr 警告) 是规模信号不是错误。先把 total_records 和 partial_failures[*].total 报给用户,列出 4 条出路,等用户明确选一个再继续。选哪条要看用户当前任务意图(对账 / 排查 / 导出),agent 不要替用户拍。永远不要 sum items 当总额(items 可能为空或部分):
--output FILE (落盘 stdout 不爆;自动放宽 cap 到 300k 行)--split-dim apikey|endpoint (服务端聚合到几十行)--endpoint <ep-...> / --apikey <ark-...>--page-limit=N (N 见 partial_failures.reason 建议;mind context size)--limit/--offset 在 fan-out 时是 per-fan-out 各 N 行 (--end 跨月或 --mine 多资源时), partial_failures 标 reason="windowed sample", agent 据此知 returned ≤ limit × fanout_countparseFloat--mine ≠ PayerID — --mine 按 IAM 子用户过滤资源,PayerID 是财务托管 owner 账号 ID,单账户场景手撸 PayerID 是 no-op (= 全账号查询)。默认 --mine-by=endpoint(infra ownership,对齐 usage stats),要看 cost causation (我的 key 在花钱) 显式 --mine-by=apikeyark_subscription,要看订阅类显式 --product ark_subscription) + profile.project 自动注入(若 profile.project 是具体 id 如 auto-test,自动按 project 过滤;default/账号全部资源哨兵/空跳过 = 真账号全量;stderr 出软提示)。要强制账号全量传 --project= (空值清空默认)../arkcli-auth/SKILL.md../arkcli-usage/SKILL.md../arkcli-pricing/SKILL.md| 命令 | 说明 |
|---|---|
billing list | 拆分账单明细查询(结算金额 × Token 用量) |