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

# 审计跟踪

> 对所有 API 活动进行不可变日志记录。

每一次 API 请求都会被记录到一份不可变的审计跟踪中。审计记录无法被修改或删除。

## 记录内容

| 字段 | 说明 |
| - | - |
| **端点** | API 路由与方法 |
| **身份** | API 密钥 ID（而非密钥本身）与用户 ID |
| **时间戳** | ISO 8601 UTC 时间戳 |
| **结果** | HTTP 状态码、所用引擎、消耗的额度 |
| **上下文** | 提示词的 SHA-256 哈希值（而非原始提示词）、激活的技能 ID、发生的工具调用 |
| **请求 ID** | 用于交叉引用的唯一标识符 |

<Note>
  审计跟踪中从不存储原始提示词，仅记录提示词的 SHA-256 哈希值，以及提示词长度和模式。这样既能保证可审计性，又不会暴露敏感内容。
</Note>

## 访问方式

```bash theme={null}
curl https://www.hitheo.ai/api/v1/audit \
  -H "Authorization: Bearer $THEO_API_KEY"
```

返回分页的审计事件，支持按日期范围、API 密钥、模式和状态码进行筛选。

## 使用场景

* **成本追踪** —— 精确查看哪些请求消耗了额度
* **调试** —— 通过请求 ID 追踪某个请求在整个流程中的处理路径
* **合规** —— 向审计人员展示访问控制与数据处理方式
* **异常检测** —— 识别异常使用模式或未经授权的访问尝试


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