可观测性与用量
查看日志、用量趋势、延迟与逐请求扣费。
你发的每个请求都会记录其模型、协议、token 数、延迟、错误(如有)以及被扣的精确 Credit。 控制台同时提供逐请求日志和聚合用量视图。
日志 vs 用量
日志
逐请求明细:模型、协议、token 用量、延迟、状态,以及被扣的 Credit。 打开一条记录可检视单个请求。
用量
聚合视图:一段时间的总量、Top 模型、Top API 密钥,以及按模型、密钥或 token 类型的 堆叠分解。
用 日志 排查具体请求,用 用量 理解一段时间内的花费与请求量。
记录了什么
每个请求你都能看到:
- 你请求的模型 slug 以及它走的协议路径。
- 输入、输出和缓存 token 数。
- 延迟 —— 首 token 时间(流式)和总耗时。
- 由 OneHop 计价引擎算出的被扣 Credit。
- 请求失败时的错误码。
延迟仅供观测
首 token、总耗时等时间字段从 OneHop 转发上游那一刻起计量。它们仅用于监控与排查, 绝不影响你被扣的金额。
失败的请求
失败请求会带一个具体错误码记录,让你能判断哪里出了问题:
upstream_timeout—— 上游或流超时。client_disconnected—— 客户端在上游响应前断开。upstream_unreachable—— 网络或 DNS 层失败。usage_unsettled—— 过了对账窗口后仍无可结算用量。
低余额提醒
在控制台设置低余额阈值,在钱包见底前收到通知。默认阈值偏保守,所以即使靠赠送 Credit 生活的账号也能在请求开始失败前得到提醒。扣费如何消耗钱包见 计费与钱包。
Agent 友好的文档
在 OneHop 之上构建 agent?本文档的每个页面都同时提供原始 Markdown —— 在任意文档 URL
末尾加 .md,即可得到一份你的模型可直接读的干净纯文本视图。