> ## 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.