arkcli agent：管理 ARK Managed Agents，包括 Agent / Skill / Env / Session / File / Memory Store / Vault / MCP OAuth。控制面优先走 ForTop/OpenTOP，Session 运行时和 Files 走数据面直联。
日本語の概要は準備中です。原文の説明を表示しています。
volcengine/ark-cli1422026年10月9日 更新
無料GitHub で公開
arkcli-pricing
查询火山引擎 ARK 基础模型结算单价（含当前账号折扣）以及 AgentPlan / CodingPlan 套餐订阅价格。Price 是账号折后单价，OriginalPrice 是公示原价。模型定价、音频/TTS/ASR 目录价格、套餐价格、折扣价、跨模态价格对比、模型免费额度走这里；实际已发生费用走 billing。只引用当前返回的计价项，目录未返回价格不等于免费或可调用。
インストール方法を見る含まれるファイル（3）
- SKILL.md9.9 KB
- references/arkcli-pricing-models.md11.8 KB
- references/arkcli-pricing-plans.md5.8 KB
SKILL.md（原文）
インストールする前に、エージェントに与えられる指示の中身を確認できます。
arkcli pricing
CRITICAL — 开始前 MUST 用 Read 工具读取 ../arkcli-shared/SKILL.md,其中包含认证闸门、配置排查与共享安全规则。
适用场景
- 查询基础模型(foundation model)的结算单价（输入 / 输出 / 批量推理 / 上下文缓存等多种 ChargeItem)
- 查看免费额度(
InferenceFreeUsage、ResourcePackItems)和欠费状态(IsOverdue) - 查看子服务开通态(
SubServices:base/context-cache/fast-infer) - 按模态过滤价格目录
- 查询 AgentPlan / CodingPlan 套餐订阅价格(个人版 + 企业版,共 12 档)
业务定位
-
“多少钱/询价”才走 pricing；“买/续费”转 arkcli-plans 的参数与协议流程，“已买了哪些”用
plans get，不能用订阅持有列表充当价格目录。 -
“已经花了多少钱”转 arkcli-billing；“还剩多少额度”转 Usage。
usage balance的免费额度、媒资库、套餐余额都不是现金余额或代金券。 -
报价必须同时说明币种、计价单位、适用模型/训练类型、档位与当前账号折扣；缺价不等于免费，单项失败不能把整个目录报成空。不要用历史价或原价再次乘折扣替代实时
Price。 -
两类定价分开管:模型按量计费(pricing models)和 套餐订阅价(pricing plans)是两个完全独立的命令。决策见下方"模型 vs 套餐"段
-
仅覆盖 foundation 模型(基础模型) 的目录式定价。但 base 模型的 ChargeItems 是全口径——既包含基础模型推理价,也包含用它做精调时的训练费率(
Finetune/LoraFinetune),以及精调出来的 custom model 调用时的推理价(FinetuneInference*/FinetuneI2I*等)。所以查 base 模型一次就能拿到所有相关费率。 -
后端 API 不返回 custom 模型(精调出来的
cm-*)单独条目——费率本来就嵌在 base 模型 ChargeItems 数组里。但 arkcli 已经做了反查糖衣:pricing models --model cm-xxx会自动调 GetCustomModel 拿到 base name 后再查价,响应顶层多挂一个resolved_custom_model字段(customization_type+foundation_model_name/foundation_model_version),Agent 据此挑对应 ChargeItem.Type 即可,不需要手动做两段式 -
不覆盖 Endpoint 维度的实际消耗 → 用 arkcli-usage
-
不含限速 / Token 上限 / context window:这些是
arkcli-models的范畴,转../arkcli-models/SKILL.md。pricing 只管"钱" -
音频目录价格与调用能力分开：
pricing models --modality Audio是有效查询；可用已确认的基础模型名进一步筛选。仅在返回对应ChargeItems时回答其价格、币种、单位和适用条件；空目录/缺计价项就说明当前价格源未覆盖，不能假定免费，也不能据此承诺支持 TTS/ASR 调用、部署或用量统计。 -
Price = 含当前账号折扣的最终单价(后端已按合同/活动/套餐计算),不需要再做客户端折扣计算
-
OriginalPrice = 公示原价;
Price < OriginalPrice即说明账号有折扣
命令
| 命令 | 说明 |
|---|---|
pricing models | 列基础模型结算单价目录(按量计费、按 token 收费) |
pricing plans | 列订阅套餐价格(AgentPlan / CodingPlan 个人版 + 企业版) |
模型 vs 套餐 — 用哪个命令
用户问的是"按 token 算的单价"还是"包月套餐价"?这是关键判别点。
| 用户措辞 | 该用 | 理由 |
|---|---|---|
| "DeepSeek-V4 多少钱" / "doubao-seed 多少钱" / "GPT-X 价格" | pricing models | 模型名 → 按 token 计费 |
| "图生图多少钱一张" | pricing models | 按调用计费,在 ChargeItems 里 |
| "音频识别每分钟多少" / "TTS 多少钱" / "语音模型费用" | pricing models --modality Audio | 查真实 ChargeItems；按返回单位报价，不默认按分钟或按 token |
| "做精调多少钱" / "精调一个模型多少 token 钱" | pricing models | 精调费率在 base 模型 ChargeItems 内嵌(看 Finetune / LoraFinetune type) |
| "我的 cm-xxx 调用多少钱" / "这个精调出来的模型多少钱" | pricing models --model cm-xxx | CLI 自动反查 base + 透出 resolved_custom_model.customization_type,按下表抽 ChargeItem |
| "Agent Plan 多少钱" / "Agent Plan 个人版 small 多少钱" | pricing plans | 套餐名 → 包月订阅 |
| "Coding Plan 多少钱" / "lite / pro 套餐价" | pricing plans | 同上 |
| "Agent Plan 企业版价格" / "团队版多少钱" | pricing plans --edition enterprise | 同上 |
混淆兜底:用户说"X 多少钱"且 X 是 model name → models;X 是 plan name → plans;两者都不像 → 先 pricing plans 列出 12 个 plan 看是否命中,再回 models。
--modality 取值映射(Agent 侧负责翻译)
后端 FoundationModelDomain 字段是5 个粗粒度枚举,arkcli 直接透传不做翻译。当用户用自然语言说"video / 图像 / 文本"时,你(Agent)需要先翻译再传:
| 用户可能说 | 后端真实枚举 | 注意 |
|---|---|---|
| 文本 / text / LLM / 语言模型 | LLM | |
| 图像 / 图片 / image / 视觉 / vision | ComputerVision | |
| 视频 / video | ComputerVision | ⚠️ 后端不区分 image/video/3D,返回包含 image 和 3D 模型 |
| 3D / hyper3d | ComputerVision | 同上 |
| 音频 / audio / 语音 / voice / TTS / ASR | Audio | 有目录价格才报价；不外推调用能力 |
| 向量 / embedding / 嵌入 | Embedding | |
| 路由 / router | Router |
重要:用户说"video 多少钱"时,你应该:
- 调
arkcli pricing models --modality ComputerVision(不能直接--modality video) - 在响应中筛出 video 类模型(看
DisplayName或FoundationModelTag),或显式告诉用户"后端按视觉大类返回,包含 image / video / 3D"
ChargeItem.Type 关键枚举对照(响应解析必备)
每个 base 模型的 ChargeItems 是全口径——可能包含基础推理、精调训练、精调推理、各类生成任务的费率混在一起。Agent 按用户问题只挑相关 1-2 条。
| 用户问题语义 | 抽哪条 Type |
|---|---|
| 推理多少钱 | InferencePrompt + InferenceCompletion |
| 批量推理多少钱 | BatchInferencePrompt + BatchInferenceCompletion |
| 上下文缓存多少钱 | ContextSessionHit + ContextSessionStorage |
| 做精调多少钱 | Finetune(全量) 或 LoraFinetune(LoRA) |
| 精调出来的模型调用多少钱 | FinetuneInferencePrompt + FinetuneInferenceCompletion |
| 图生图多少钱(base 模型) | T2ICompletion / I2ICompletion |
| 图生图多少钱(精调模型) | FinetuneT2ICompletion / FinetuneI2ICompletion |
| 视频生成 | T2VCompletion / I2VCompletion / V2VCompletion(及 1080/4K 变体) |
| 3D 生成 | To3DCompletion / FinetuneTo3DCompletion |
| 低延迟推理 | FastInferencePrompt / FastInferenceCompletion |
完整 Type 枚举见 references/arkcli-pricing-models.md 的「ChargeItem.Type 全枚举对照」段落。
CustomizationType → ChargeItem.Type 映射
pricing models --model cm-* 的响应顶层会带 resolved_custom_model.customization_type,据此挑费率 — 完整对照表见 references/arkcli-pricing-models.md 的「Custom model(cm-*)反查」段落。
快速决策
- 用户问"X 模型多少钱":
arkcli pricing models --model X,从ChargeItems抽InferencePrompt/InferenceCompletion - 用户问"我的 cm-xxx 多少钱":
arkcli pricing models --model cm-xxx,看响应resolved_custom_model.customization_type→ 按上面映射表抽Finetune*那条;resolved_custom_model.foundation_model_name顺带告知用户它的 base 是什么 - 用户问"所有 LLM 价格":
arkcli pricing models --modality LLM - 用户问"TTS / ASR / 语音模型多少钱":不执行 pricing；转
arkcli models search <keyword>只说明可发现与当前不支持费用查询 - 用户问"Agent Plan / Coding Plan 多少钱":
arkcli pricing plans列全 12 档,或带--plan agent-plan-personal-small单查 - 用户问"我有什么免费额度":
pricing models,看InferenceFreeUsage和ResourcePackItems[Type=FreeInference] - 用户问"我账号有折扣吗":对比
PricevsOriginalPrice,差值即折扣(两个命令都支持) - 用户问"我的实际消耗":这不是 pricing 的事,转 arkcli-usage
- 企业版套餐没权限:
pricing plans会把那 6 行 enterprise 的error字段填成AccessDenied: ...,其余 6 行 personal 正常返。这是预期行为,不是 bug
常见降级
- 鉴权错误:转
../arkcli-auth/SKILL.md - 用户在问消耗(已发生的用量)而非单价:转
../arkcli-usage/SKILL.md - 音频价格源没有目标模型/计价项：说明查询范围与缺口；用户仍需该产品报价时，转其官方计费文档核验，不把另一模型价格套过来。
参考
- arkcli-usage — 实际 token / 请求消耗(含历史范围)
- arkcli-deploy — 创建 Endpoint(部署前自动检测开通)
- arkcli-shared — 认证和全局参数
レビュー
まだレビューはありません。使ってみた感想をお寄せください。
同じリポジトリのスキル
概要と使いどころ
Inspect or invoke locally registered ArkCLI actions when product commands cannot cover a task. Use for registry errors or exact raw payloads. Not for public API catalogs or OpenAPI schemas.
日本語の概要は準備中です。原文の説明を表示しています。
volcengine/ark-cli1422026年10月9日 更新
arkcli 认证管理：交互式登录、Volc SSO 登录、查看状态、退出登录、生成 ARK API Key (apikey)、以及云开发机/CI 用 `arkcli init-volc` 从 VOLC_INIT_* 环境变量无交互引导 platform profile。0.1.16 起 SSO 登录走 Gate 1+2 自动绑定 Profile 切面 (type/region/project/owner_trn)；AK/SK login 通道暂关。当用户需要初始化凭证、排查鉴权问题、切换认证方式、生成或重选 ARK API Key、或在已注入凭证的环境无交互引导时使用。反触发：用户问 TTS/ASR/语音模型能力、接入或调用时，不要引导 `auth apikey`，只转 models search 说明 arkcli 当前仅支持广场发现。
日本語の概要は準備中です。原文の説明を表示しています。
volcengine/ark-cli1422026年10月9日 更新
查询火山引擎 ARK 拆分账单明细（结算金额、Token 用量计费），支持按账期月、月范围、Endpoint、API Key、产品编码等维度过滤。当用户问账单、花了多少钱、对账、账期、按 EP / API Key 拆账、按产品拆账、月度账单、出账明细时使用。注意 billing 跟 usage stats 不同：stats 出推理量（近实时），billing 出结算金额（T+1 出账，财务口径）。
日本語の概要は準備中です。原文の説明を表示しています。
volcengine/ark-cli1422026年10月9日 更新
arkcli +chat：通过数据面 Responses API 快速对话/推理，支持多模态、流式、多轮、临时 API Key/Base URL/Endpoint 执行与无副作用 dry-run。当用户给出 Endpoint 但未说明工作流时，先用 resources resolve 识别候选；已经出现 Responses API capability/access 错误时，只读用 models get 核对精确模型的 api_support，不重试真实调用。有明确产出形态的多模态理解走 arkcli-understand。
日本語の概要は準備中です。原文の説明を表示しています。
volcengine/ark-cli1422026年10月9日 更新
arkcli +code-example：为指定基础模型生成多语言（Python / Go / Java / Node / curl）调用示例代码并写入本地文件。数据源是火山方舟 OpenTOP OpenGetSampleCode。当用户需要拿某个基础模型的 SDK / curl 调用示例、保存为本地接入模板时使用。反触发：TTS/ASR/语音模型没有 arkcli 示例代码路径，不能靠补版本解决，只能转 models search 说明当前不支持。
日本語の概要は準備中です。原文の説明を表示しています。
volcengine/ark-cli1422026年10月9日 更新