arkcli-pricing

# arkcli pricing **CRITICAL — 开始前 MUST 用 Read 工具读取 [`../arkcli-shared/SKILL.md`](../arkcli-shared/SKILL.md),其中包含认证闸门、配置排查与共享安全规则。** ## 适用场景 - 查询基础模型(foundation model)的结算单价（输入 / 输出 / 批量推理 / 上下文缓存等多种 ChargeItem) - 查看免费额度(`InferenceFreeUsage`、`ResourcePackItems`)和欠费状态(`IsOverdue`) - 查看子服务开通态(`SubServices`:`base` / `context-cache` / `fast-infer`) - 按模态过滤价格目录 - 查询 **AgentPlan / CodingPlan 套餐订阅价格**(个人版 + 企业版,共 12 档) ## 业务定位 - “多少钱/询价”才走 pricing；“买/续费”转 [arkcli-plans](../arkcli-plans/SKILL.md) 的参数与协议流程，“已买了哪些”用 `plans get`，不能用订阅持有列表充当价格目录。 - “已经花了多少钱”转 [arkcli-billing](../arkcli-billing/SKILL.md)；“还剩多少额度”转 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](../arkcli-usage/SKILL.md) - **不含限速 / Token 上限 / context window**:这些是 `arkcli-models` 的范畴,转 [`../arkcli-models/SKILL.md`](../arkcli-models/SKILL.md)。pricing 只管"钱" - **音频目录价格与调用能力分开**：`pricing models --modality Audio` 是有效查询；可用已确认的基础模型名进一步筛选。仅在返回对应 `ChargeItems` 时回答其价格、币种、单位和适用条件；空目录/缺计价项就说明当前价格源未覆盖，不能假定免费，也不能据此承诺支持 TTS/ASR 调用、部署或用量统计。 - **Price = 含当前账号折扣的最终单价**(后端已按合同/活动/套餐计算),不需要再做客户端折扣计算 - **OriginalPrice = 公示原价**;`Price < OriginalPrice` 即说明账号有折扣 ## 命令 | 命令 | 说明 | |------|------| | [`pricing models`](references/arkcli-pricing-models.md) | 列基础模型结算单价目录(按量计费、按 token 收费) | | [`pricing plans`](references/arkcli-pricing-plans.md) | 列订阅套餐价格(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 多少钱"时,你应该: 1. 调 `arkcli pricing models --modality ComputerVision`(不能直接 `--modality video`) 2. 在响应中筛出 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`](references/arkcli-pricing-models.md) 的「ChargeItem.Type 全枚举对照」段落。 ## CustomizationType → ChargeItem.Type 映射 `pricing models --model cm-*` 的响应顶层会带 `resolved_custom_model.customization_type`,据此挑费率 — 完整对照表见 [`references/arkcli-pricing-models.md`](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](../arkcli-usage/SKILL.md) - **企业版套餐没权限**:`pricing plans` 会把那 6 行 enterprise 的 `error` 字段填成 `AccessDenied: ...`,其余 6 行 personal 正常返。这是预期行为,不是 bug ## 常见降级 - 鉴权错误:转 [`../arkcli-auth/SKILL.md`](../arkcli-auth/SKILL.md) - 用户在问消耗(已发生的用量)而非单价:转 [`../arkcli-usage/SKILL.md`](../arkcli-usage/SKILL.md) - 音频价格源没有目标模型/计价项：说明查询范围与缺口；用户仍需该产品报价时，转其官方计费文档核验，不把另一模型价格套过来。 ## 参考 - [arkcli-usage](../arkcli-usage/SKILL.md) — 实际 token / 请求消耗(含历史范围) - [arkcli-deploy](../arkcli-deploy/SKILL.md) — 创建 Endpoint(部署前自动检测开通) - [arkcli-shared](../arkcli-shared/SKILL.md) — 认证和全局参数