跳到主要内容

用量与调用日志

调用日志记录 API 请求的模型、API 密钥、分组、Token 用量、响应速度和实际费用。遇到余额变化、模型错误或响应速度问题时，应先从调用日志开始排查。

打开调用日志​

  1. 登录 Bita API 并进入控制台。
  2. 在左侧导航栏中点击「使用日志」。

Bita API 调用日志

筛选调用记录​

日志页面顶部提供多种筛选条件：

时间范围​

选择需要查看的开始时间和结束时间。排查某次请求时，建议将范围缩小到请求前后几分钟，避免结果过多。

模型名称​

输入模型 ID，只查看指定模型的调用记录。请使用模型广场中的准确模型名称。

分组​

按 default、claude-origin、gpt-origin 等分组筛选，适合核对不同分组的模型可用性和计费倍率。

日志类型​

使用「所有类型」筛选不同类型的日志。可选类型由平台当前配置决定。

更多条件​

点击「展开」可以显示页面提供的其他筛选条件。设置完成后点击「搜索」，点击「重置」可以清除筛选条件。

页面右上角的「全部」和「仅自己」用于切换日志范围。实际可查看范围取决于当前账户权限；普通用户通常只需要查看自己的调用。

查看汇总指标​

筛选区域下方会显示当前查询范围的汇总指标：

指标说明
用量当前筛选结果产生的总费用或总消耗
RPM每分钟请求数（Requests Per Minute）
TPM每分钟 Token 数（Tokens Per Minute）

RPM 和 TPM 常用于判断调用频率与流量规模。它们为 0 时，不一定表示没有历史调用，还需要确认选择的时间范围以及当前统计窗口。

阅读日志表格​

每一行对应一次 API 调用。页面中的主要字段包括：

字段说明
时间请求发生的具体时间以及日志类型
渠道处理请求的上游渠道；是否显示取决于账户权限
用户发起调用的账户
令牌使用的 API 密钥名称、分组和分组倍率
模型本次请求使用的准确模型 ID
流是否使用流式响应，以及流式生成速度
Tokens输入、输出以及缓存相关 Token 数量
费用本次请求最终产生的实际费用

点击支持排序的列标题，可以按时间、模型、Token 或费用等字段调整结果顺序。

API 密钥与分组​

「令牌」列中的钥匙标签表示本次请求使用的 API 密钥名称。名称下方会显示该密钥所属分组和分组倍率，例如：

claude-origin  0.7x

这组信息可以帮助确认：

  • 请求是否使用了预期的 API 密钥
  • API 密钥分组是否正确
  • 本次费用使用了哪个分组倍率
  • 异常调用来自哪个工具或项目

如果所有密钥都使用相同名称，就很难从日志识别调用来源。因此建议一个工具使用一枚独立且名称清晰的密钥。

流式响应与生成速度​

「流」表示请求采用流式响应。流式请求会在模型生成内容时逐步返回数据。

流式标记下方的 t/s 表示每秒生成的 Token 数，可用于观察模型响应速度。例如 27 t/s 表示平均每秒生成约 27 个 Token。

t/s 会受到模型、请求内容、上下文长度、上游负载和网络状况影响，单次结果不能代表模型长期性能。

Token 与缓存​

Tokens 列通常用两个主要数字展示输入和输出 Token，例如：

94 / 107

通常左侧为输入 Token，右侧为输出 Token。对于支持提示词缓存的模型，下一行还可能显示缓存读取和缓存写入数量。

  • 缓存读取：本次请求从已有缓存中复用的 Token。
  • 缓存写入：本次请求新写入缓存的 Token。

不同模型返回的用量字段可能不同，应以日志当前展示和接口响应中的 usage 数据为准。

Token 数量不等于最终费用

最终费用还会受到模型输入价格、输出价格、缓存价格、定价类型和 API 密钥分组倍率影响。核对费用时不能只比较 Token 总数。

查看单次调用费用​

「费用」列显示该次请求最终产生的费用。核对一条记录时，建议同时查看：

  1. 模型 ID
  2. 输入和输出 Token
  3. 缓存读取与写入
  4. API 密钥分组倍率
  5. 模型广场当前价格
  6. 最终费用

部分请求可能先预扣预计费用，完成后再按实际用量结算。调用日志中的最终费用比请求过程中的临时余额变化更适合用于核对。

排查异常余额消耗​

如果余额下降速度超出预期：

  1. 选择出现异常的时间范围。
  2. 按费用排序，优先查看费用较高的记录。
  3. 检查模型 ID、Token 数量和缓存数据。
  4. 查看记录使用的 API 密钥名称和分组。
  5. 确认该密钥是否仍由已知工具或项目使用。
  6. 如果发现无法识别的调用，立即停用对应密钥。
  7. 创建新密钥并更新可信客户端。

还应检查是否存在过长的对话上下文、重复重试、无人值守的自动任务或意外选择高价模型等情况。

排查调用失败​

调用失败时，可以将客户端错误与日志信息一起核对：

问题日志中重点查看
模型不可用模型 ID、API 密钥分组和日志消息
额度不足API 密钥、费用和账户余额
响应缓慢模型、流式状态、t/s 和发生时间
请求重复相同时间段内的重复模型和 API 密钥记录
费用异常Token、缓存、分组倍率和最终费用

向平台人员反馈问题时，可以提供时间、模型 ID、脱敏后的 API 密钥名称和错误消息，但不要提供完整 API 密钥。

定期检查建议​

  • 定期查看近期总用量和高费用记录。
  • 为不同工具使用不同 API 密钥名称。
  • 对比模型价格和实际调用费用。
  • 检查不再使用的密钥是否仍有调用。
  • 发现异常后先停用密钥，再排查来源。

下一步​

了解 API 请求地址和身份验证方式，请继续阅读Base URL 与身份验证。