Arkcli Pricing

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 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 只管"钱"
• 不覆盖语音模型费用：TTS / ASR / 配音 / 朗读 / 播客 / 音色 / 实时语音交互，或 doubao-seed-tts-* / doubao-seed-asr-* / seedasr-* 等广场语音模型，当前在 arkcli 只支持 models search 发现；不要用 pricing models --model 或 --modality Audio 回答其价格
• Price = 含当前账号折扣的最终单价(后端已按合同/活动/套餐计算),不需要再做客户端折扣计算
• OriginalPrice = 公示原价;Price < OriginalPrice 即说明账号有折扣

命令

模型 vs 套餐 — 用哪个命令

用户问的是"按 token 算的单价"还是"包月套餐价"?这是关键判别点。

混淆兜底:用户说"X 多少钱"且 X 是 model name → models;X 是 plan name → plans;两者都不像 → 先 pricing plans 列出 12 个 plan 看是否命中,再回 models。

--modality 取值映射(Agent 侧负责翻译)

后端 FoundationModelDomain 字段是5 个粗粒度枚举,arkcli 直接透传不做翻译。当用户用自然语言说"video / 图像 / 文本"时,你(Agent)需要先翻译再传:

重要:用户说"video 多少钱"时,你应该:

1. 调 arkcli pricing models --modality ComputerVision(不能直接 --modality video)
2. 在响应中筛出 video 类模型(看 DisplayName 或 FoundationModelTag),或显式告诉用户"后端按视觉大类返回,包含 image / video / 3D"

ChargeItem.Type 关键枚举对照(响应解析必备)

每个 base 模型的 ChargeItems 是全口径——可能包含基础推理、精调训练、精调推理、各类生成任务的费率混在一起。Agent 按用户问题只挑相关 1-2 条。

完整 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]
• 用户问"我账号有折扣吗":对比 Price vs OriginalPrice,差值即折扣(两个命令都支持)
• 用户问"我的实际消耗":这不是 pricing 的事,转 arkcli-usage
• 企业版套餐没权限:pricing plans 会把那 6 行 enterprise 的 error 字段填成 AccessDenied: ...,其余 6 行 personal 正常返。这是预期行为,不是 bug

常见降级

• 鉴权错误:转 ../arkcli-auth/SKILL.md
• 用户在问消耗(已发生的用量)而非单价:转 ../arkcli-usage/SKILL.md
• 用户在问语音模型费用 / TTS 定价 / ASR 价格:转 ../arkcli-models/SKILL.md 只说明广场可搜和当前 arkcli 不支持费用查询

参考

• arkcli-usage — 实际 token / 请求消耗(含历史范围)
• arkcli-deploy — 创建 Endpoint(部署前自动检测开通)
• arkcli-shared — 认证和全局参数