OpenNave 文档中心

外观

计费与定价 ​

OpenNave 的文本模型通常按处理的 Token 数量计费。输入、输出、缓存和推理 Token 可能使用不同费率，实际价格以控制台和接口返回信息为准。

计费机制 ​

按 Token 定价 ​

Token 类型说明
输入 Token提示词、系统消息和上下文中的内容。
输出 Token模型生成的响应内容。
缓存读取 Token从 Prompt 缓存读取的输入，通常使用较低费率。
缓存写入 Token写入 Prompt 缓存的输入，可能使用独立费率。
短时缓存写入 Token部分供应商提供短时效缓存，费率可能不同。
推理 Token支持推理的模型可能将推理输出按独立费率计费。

价格通常以美元每百万 Token（$/M tokens）展示。输出 Token 的单价一般高于输入 Token。

阶梯定价 ​

部分模型会按单次请求的 Token 数量采用阶梯定价：

  • 阈值阶梯：总 Token 超过某个阈值后，整次请求按新的费率计算。
  • 范围阶梯：不同 Token 区间分别按不同费率计算，类似累进计费。

模型倍率可能用于折扣、免费模型或溢价。若有多个优惠来源，系统以当次请求的实际消费记录为准。

计费去重 ​

请求因通道故障转移而在内部重试时，应只对成功响应计费一次。应用侧仍应使用业务幂等键，防止主动重复提交造成多次消费。

查看定价和余额 ​

可在 OpenNave 控制台查看当前可用模型、Token 单价、余额、用量和消费日志。模型信息也可以通过公开接口读取：

sh
curl "https://api.opennave.top/web/v1/models"

需要身份凭据的余额接口示例：

sh
curl "https://api.opennave.top/web/v1/self" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

余额字段可能以内部最小单位返回。界面显示与实际可用余额规则以控制台说明为准。

余额不足 ​

余额不足时，代理接口如 /v1/responses、/v1/messages、/v1beta/models/* 通常返回 HTTP 402 Payment Required；管理接口 /web/v1/* 可能按其统一错误格式返回。充值或恢复余额后再重试请求。

消费追踪 ​

控制台通常提供以下消费视图：

  • 仪表盘：余额、累计消费、请求数、Token 用量与趋势。
  • 用量：按 API Key 和日期范围汇总统计。
  • 消费日志：单次请求的时间、模型、输入输出 Token、费用与 API Key 标识。

使用独立 API Key 区分项目或环境，有助于成本归集和异常排查。

费用估算 ​

调用前可粗略估计输入量：

  • 英文文本约每 4 个字符 1 个 Token，或每个单词约 0.75 个 Token。
  • 代码的 Token 密度通常接近英文文本，但与语言和符号密度有关。
  • 中日韩文字通常每字符约 1 至 2 个 Token。

更准确的估算应使用 Token 计数 接口。单次预计成本可按“输入 Token 数乘以输入费率，加上预计输出 Token 数乘以输出费率”计算。

最佳实践 ​

  • 定期查看余额、用量和消费趋势。
  • 根据任务复杂度选择合适模型，简单任务优先使用成本较低的模型。
  • 优化并缩短提示词，减少不必要的上下文。
  • 为 API Key 设置适当用量限制，避免意外超支。
  • 缓存可复用响应，并为业务请求设置幂等键。

关联文档 ​