日志与问题排查

日志中请保留 TokenLab 的请求 ID、任务 ID 和 billing_transaction_id。不用保存提示词或私密媒体，也能把一次用户操作与结果和费用对应起来。

从请求详情到调查和人工支持Copy Anchor Link

1. 在请求所属工作区打开请求记录，用请求 ID 找到并点开对应记录。

2. 选择打开完整详情进入独立详情页，返回请求列表会恢复原筛选。链接不会授予其他工作区的访问权限；请使用有权访问该工作区的账号。

3. 处理中或状态未知时，先刷新进度。明确失败或接收中断时，可选择调查原因，在站内 Agent 中调查这条请求，不会重新发送原模型请求。正常成功的请求默认不需要调查。

4. 仍需帮助时，从请求或调查中选择联系人工，先打开预览；可用时会关联原请求和会话。核对摘要并移除私密内容，再明确点击提交。开始调查或打开预览本身不会发送客服请求。

5. 提交后保留确认回执，在支持中继续同一会话，查看回复、补充信息，避免重复提交。

建议保留的 IDCopy Anchor Link

面向用户的记录只使用 TokenLab ID。私有服务地址、缓存键和诊断信息都不能展示给用户。

记录内容Copy Anchor Link

下面这些信息足够用于排查，同时不会泄露请求内容：

• 端点、HTTP 方法、模型、状态码、时间戳和延迟。
• request_id、task_id、poll_url 和 billing_transaction_id（如有）。
• 请求中使用了哪些字段，不记录完整提示词或私密媒体。
• 异步任务的最终状态和可安全保存的错误字段。
• 客户端重试次数，以及重试是创建了新任务还是继续查询原任务。

除非你获得明确的保留权限，否则始终删除 Authorization、API 密钥、管理令牌、签名 URL、私有媒体 URL、完整提示和用户个人数据。

故障排除矩阵Copy Anchor Link

用量与费用核对Copy Anchor Link

服务端可以通过 Management API 查询：

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"

GET /v1/management/api-keys/{keyId}/usage 支持按 scene、model、modelVendor、startDate 和 endDate 筛选。请使用这些记录，不要抓取 Console 页面，也不要只根据响应 token 数自行计算费用。

流式响应可能在内容发送完后才结算，因此响应里没有账单 ID，Usage 中仍可能稍后出现。异步媒体任务也可能在最终状态后完成费用记录。

联系支持时提供什么Copy Anchor Link

联系支持时，请包括：

• request_id。
• 异步任务的 task_id 和 poll_url。
• billing_transaction_id（如有）。
• API 地址、方法、模型、时间和状态码。
• 请求中使用的字段名，以及可安全分享的错误内容。
• 你期望的结果和用户实际看到的内容。

不要发送 API 密钥、管理令牌、私密媒体、完整提示词、私有服务地址或诊断 ID。需要请求示例时，只发送脱敏版本。

值得自动检查的项目Copy Anchor Link

• 分别统计重复出现的 401、402、429 和 5xx，它们需要不同的处理方式。
• 找出超过产品等待时间仍未完成的异步任务。
• 找出同一个用户任务的重复创建请求。
• 抽查已完成任务，确认用户看到的文件、Usage 和本地任务记录一致。

API 参考Copy Anchor Link