> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 如何查看和使用调用日志？

> 说明老张API控制台调用日志的用途、可见元数据、默认内容边界、通常保留时间，以及排查调用失败时应提供的脱敏信息。

登录[调用日志页面](https://api.laozhang.ai/log)，按时间、模型、状态或其他当前可用条件查找请求。调用日志主要用于核对计费、路由、错误类别和请求状态；老张API默认不保存 API prompt 或 response 内容。

本页依据 [老张API数据政策](https://www.laozhang.ai/zh-cn/data-policy) 整理，最后核对日期为 **2026 年 10 月 5 日**。控制台字段和筛选能力可能调整，以当前页面为准。

## 日志可能包含什么

根据数据政策，请求元数据可能包括：

* 账户或 API Key 标识；
* 时间戳、模型、端点和路由；
* Token、用量或计费单位；
* 请求状态和错误类别；
* 延迟和路由信息；
* 安全、防滥用和服务完整性所需信息。

## 默认不包含什么

老张API默认不保存 API prompt 和 response 内容。上游模型和基础设施服务商可能适用自己的日志、保留和安全审查规则，具体边界不能从老张API调用日志页面反推。

## 看懂日志里的扣费

每条消费记录列出这次请求的模型、输入（提示）tokens、输出（补全）tokens、扣费金额，以及一行计费说明。计费说明中的倍率可以这样换算成单价：

| 计费说明中的项 | 含义 |
| - | - |
| 模型倍率 | 输入单价 = 模型倍率 × 2，单位为美元 / 1M tokens |
| 补全倍率 | 输出单价 = 输入单价 × 补全倍率 |
| 分组倍率 | 令牌分组的倍率，扣费再乘以它 |
| 按次使用固定价格 | 按次计费模型的单次价格 |

例如「模型倍率 1，分组倍率 1，补全倍率 5」对应输入 \$2、输出 \$10 / 1M tokens，与[模型与价格总表](/models)中 `gpt-6-sol` 的价格一致。

* **按量模型**：接口响应 `usage` 中的 token 数与日志同源，可以自己核算。费用 =（未命中缓存的输入 × 输入单价 + 命中缓存的输入 × 缓存读取单价 + 输出 × 输出单价）÷ 1,000,000 × 分组倍率。
* **推理模型**：思考过程的 tokens 计入输出，但不出现在回复正文中。
* **按次模型**：日志里也可能显示 token 数，但金额不由它推导；同样参数的调用每次金额相同。
* 接口响应不返回金额，需要成本时用 `usage` 和单价计算。

**没有扣费的失败请求不会出现在消费记录里。** 参数错误、鉴权失败、余额不够预扣等在执行前被拒绝的请求，错误只在接口响应中返回。反过来，日志里有这条扣费记录，说明请求已经到达上游并产生了消耗；客户端没收到结果时，可以据此判断问题出在返回途中。

## 保留时间

故障排查日志通常保留 **7 天**。为安全、防滥用调查、账单争议、法律合规或服务完整性而合理需要时，相关元数据可能保留更长时间。

账单、交易、账户、安全事件和用户主动提交的客服材料适用不同的保留目的和期限，详见[数据政策](https://www.laozhang.ai/zh-cn/data-policy)。

## 排查调用失败

1. 记录失败发生的准确时间和时区；
2. 确认模型 ID、端点和 API Key 分组；
3. 查看 HTTP 状态、平台错误信息和是否产生计费；
4. 使用最小请求复现，区分参数、权限、余额、路由和上游错误；
5. 无法解决时，把脱敏后的证据发送给支持团队。

建议提供：

* 账户邮箱或用户名；
* 请求时间和时区；
* 模型 ID、端点和令牌分组；
* HTTP 状态码、错误类别和脱敏错误信息；
* 控制台中可用于定位的请求标识；
* 是否重试以及重试结果。

<Warning>
  不要发送完整 API Key、密码、完整 prompt/response、受监管数据或无关的客户资料。不要假设文档中存在公开的日志查询 API；可用接口以当前控制台和正式 API 文档为准。
</Warning>

## 相关文档

* [老张API如何处理数据与日志](/faq/data-security)
* [为什么还有余额但调用失败](/faq/balance-insufficient)
* [API Key 获取与管理](/faq/token-management)
* [老张API数据政策](https://www.laozhang.ai/zh-cn/data-policy)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.