计费与分组 — ZCloudAPI

模型详情中的基础价格、分组倍率和使用日志共同决定实际扣费。查看价格时先确认模型、计费单位和分组，再比较数字；不要只看货币符号或把倍率误认为额外加价。

计费关系

对于按 Token 计费的模型，可以先用下面的关系理解：

实际单价 = 模型基础价格 x 分组倍率
预计费用 = 输入费用 + 输出费用 + 缓存读取费用 + 缓存写入费用 + 其他按次费用

使用日志中的最终扣费还会使用该次请求的实际 Token、命中的分组、模型计费规则和精度。手工估算用于核对量级，账单事实以使用日志为准。

基础价格

基础价格是倍率应用前的模型价格。按 Token 计费的模型通常以每 1M tokens 展示输入、输出和缓存价格；图片、音频或特殊能力也可能按次、按张、按秒或按其他单位计费。

核对时必须同时确认：

完整模型名和版本号。
单位是 1K、1M、按次还是其他单位。
价格对应输入、输出、缓存读取还是缓存写入。
是否有长上下文、峰谷时段或其他动态规则。
你查看的是基础价格还是已经应用倍率的分组价格。

模型的当前数字以 https://console.zcloudapi.com 的模型价格页和详情弹窗为准。

国产模型的 1:1 展示约定

这一约定只用于“国产模型”分组中的模型。 国产模型的基础价格数字按人民币与美元 1:1 录入和展示，不再做额外的汇率换算。

例如，某国产模型官方基础价格是输入 8、输出 28，模型详情中的基础价格数字也按输入 8、输出 28 理解。这里需要对齐的是基础价格数字本身，不要因为页面当前显示 $ 或 ¥ 就把数字再乘除汇率。

这条规则不应外推到 GPT、Claude、Gemini、Grok 等其他模型。非国产模型按其详情页展示的官方价格、平台基础价格和说明计算。

分组倍率就是相对基础价的折扣

对于国产模型，分组倍率表示相对官方基础价格的折扣：

分组倍率	含义	基础输入价为 `8` 时的分组输入价
`1.0x`	原基础价	`8`
`0.8x`	8 折，即支付基础价的 80%	`6.4`
`0.5x`	5 折，即支付基础价的 50%	`4`

因此，0.8x 不是“在基础价上再增加 0.8 倍”，而是最终单价为基础价的 0.8 倍。

模型详情会直接展示各分组价格。核对时可以用“基础价格 x 分组倍率”复算一次，并检查结果是否与详情和使用日志一致。

非国产模型的价格说明

模型详情会根据模型定价来源显示对应公式：

有官方定价换算规则的模型，按详情中的官方价格换算说明，再乘分组倍率。
使用平台基础价格的模型，按平台基础价格乘分组倍率。
图片、音频和其他按次模型，以详情页标注的计费单位和分组价格为准。

国产模型的“人民币与美元 1:1 展示、倍率等于相对官价折扣”说明不会应用到其他分组。

输入、输出与缓存

一次请求可能包含多种用量：

用量类型	常见含义	核对重点
输入 Token	提示词、历史消息、工具定义和部分系统内容	长会话会持续增长
输出 Token	模型生成的正文、推理或工具参数	通常单价高于输入
缓存读取	命中已缓存上下文后读取的 Token	只有模型和请求满足缓存条件时出现
缓存写入	首次写入可复用上下文的 Token	部分模型单独计费且高于缓存读取
按次费用	图片、音频、搜索或其他特殊能力	单位不一定是 Token

“缓存价格”有时只指缓存读取；如果模型区分缓存读取和缓存写入，详情会分别列出。不要用缓存读取价格估算首次缓存写入费用。

长上下文与动态价格

部分模型会在输入超过指定上下文阈值后使用另一档基础价格，也可能存在时段、峰谷或供应商动态计费。此时不能只用详情顶部的短上下文基础价格估算整次请求。

上线前建议分别测试：

短输入和小输出。
接近业务常用上下文长度的请求。
超过长上下文阈值的请求。
有缓存命中和无缓存命中的请求。

每次都到使用日志核对 Token 类型和扣费。动态规则调整后，价格页和模型详情是当前依据，第三方截图或旧文档可能已经过期。

`auto` 分组如何计费

你可以在控制台创建自己的分组顺序，并让多把 Key 共用一份配置，操作步骤见自定义 Auto 分组。个人配置和官方 Auto 都按实际命中的分组计费。

auto 代表自动选择实际路由，不代表所有模型使用同一个固定价格。请求进入 auto 后，系统会根据模型和当前配置命中实际分组与渠道，并按实际计费上下文记录日志。

核对 auto 请求时至少查看：

请求模型名。
使用日志中的 group 或实际命中分组。
实际 channel 或路由记录。
输入、输出、缓存用量。
最终扣费。

不要只根据 API Key 表面选择了 auto 就假设固定倍率。生产预算和异常排查应以实际命中记录为准。

手工估算示例

假设某国产模型的基础价格为：

输入: 8 / 1M tokens
输出: 28 / 1M tokens
缓存读取: 2 / 1M tokens
分组倍率: 0.8x

一次请求使用 100,000 输入 Token、20,000 输出 Token、50,000 缓存读取 Token，则估算为：

输入费用 = 8 x 0.8 x 100,000 / 1,000,000 = 0.64
输出费用 = 28 x 0.8 x 20,000 / 1,000,000 = 0.448
缓存读取费用 = 2 x 0.8 x 50,000 / 1,000,000 = 0.08
预计合计 = 1.168

这是解释公式的示例，不代表某个具体模型的当前定价。实际模型数字、长上下文规则和分组倍率以价格页为准。

在控制台核对扣费

打开 https://console.zcloudapi.com 的模型价格页，搜索完整模型名。
打开详情，记录基础输入、输出、缓存价格和计费单位。
查看 API Key 所在分组及详情中的分组倍率或分组价格。
发起一次输入和输出都很小的非流式请求。
打开「使用日志」，找到同一时间的记录。
核对模型、group、输入、输出、缓存、耗时和扣费。
如果是 auto，额外确认实际命中分组和渠道。

常见误解

误解	正确理解
页面显示美元，所以国产模型数字要再除汇率	国产模型基础价格数字按人民币与美元 1:1 展示，不额外换算
`0.8x` 是加价 80%	`0.8x` 是支付基础价的 80%，即 8 折
模型广场价格就是所有 Key 的最终价格	模型广场展示基础和分组信息，实际还取决于请求分组和计费规则
`auto` 永远使用一个固定倍率	`auto` 按当前路由命中实际分组，应从日志确认
有缓存字段就一定按缓存价收费	只有实际产生缓存读取或写入用量时才应用对应价格
长上下文也使用顶部短上下文价	超过阈值后可能进入另一档价格，需看模型详情

预算与安全建议

为开发、测试、生产分别创建 API Key 和额度上限。
先用典型请求测出输入、输出和缓存分布，再估算月度成本。
为高输出模型设置合理的最大输出 Token。
对长会话定期压缩或重建上下文，避免输入无限增长。
监控用量和余额变化，对异常模型、分组或时间段及时停用对应 Key。
价格或倍率调整后，用小请求重新完成“模型详情 -> 使用日志 -> 余额变化”的核对闭环。