billing_transaction_id。不用保存提示词或私密媒体,也能把一次用户操作与结果和费用对应起来。
从请求详情到调查和人工支持
- 在请求所属工作区打开请求记录,用请求 ID 找到并点开对应记录。
- 选择打开完整详情进入独立详情页,返回请求列表会恢复原筛选。链接不会授予其他工作区的访问权限;请使用有权访问该工作区的账号。
- 处理中或状态未知时,先刷新进度。明确失败或接收中断时,可选择调查原因,在站内 Agent 中调查这条请求,不会重新发送原模型请求。正常成功的请求默认不需要调查。
- 仍需帮助时,从请求或调查中选择联系人工,先打开预览;可用时会关联原请求和会话。核对摘要并移除私密内容,再明确点击提交。开始调查或打开预览本身不会发送客服请求。
- 提交后保留确认回执,在支持中继续同一会话,查看回复、补充信息,避免重复提交。
建议保留的 ID
面向用户的记录只使用 TokenLab ID。私有服务地址、缓存键和诊断信息都不能展示给用户。
记录内容
下面这些信息足够用于排查,同时不会泄露请求内容:- 端点、HTTP 方法、模型、状态码、时间戳和延迟。
request_id、task_id、poll_url和billing_transaction_id(如有)。- 请求中使用了哪些字段,不记录完整提示词或私密媒体。
- 异步任务的最终状态和可安全保存的错误字段。
- 客户端重试次数,以及重试是创建了新任务还是继续查询原任务。
Authorization、API 密钥、管理令牌、签名 URL、私有媒体 URL、完整提示和用户个人数据。
故障排除矩阵
用量与费用核对
服务端可以通过 Management API 查询:GET /v1/management/api-keys/{keyId}/usage 支持按 scene、model、modelVendor、startDate 和 endDate 筛选。请使用这些记录,不要抓取 Console 页面,也不要只根据响应 token 数自行计算费用。
流式响应可能在内容发送完后才结算,因此响应里没有账单 ID,Usage 中仍可能稍后出现。异步媒体任务也可能在最终状态后完成费用记录。
联系支持时提供什么
联系支持时,请包括:request_id。- 异步任务的
task_id和poll_url。 billing_transaction_id(如有)。- API 地址、方法、模型、时间和状态码。
- 请求中使用的字段名,以及可安全分享的错误内容。
- 你期望的结果和用户实际看到的内容。
值得自动检查的项目
- 分别统计重复出现的
401、402、429和5xx,它们需要不同的处理方式。 - 找出超过产品等待时间仍未完成的异步任务。
- 找出同一个用户任务的重复创建请求。
- 抽查已完成任务,确认用户看到的文件、Usage 和本地任务记录一致。