要捕获的公共标识符
| 标识符 | 出现位置 | 用途 |
|---|---|---|
request_id | 错误主体、仪表板日志、使用记录 | 请求级支持和对账 |
id / task_id | 异步创建和状态响应 | 轮询图像、视频、音乐和 3D 作业 |
poll_url | 异步创建响应 | 首选状态 URL |
billing_transaction_id | 结算时的非流式响应、异步任务状态响应、使用记录、X-Billing-Transaction-ID | 成本对账 |
X-Task-ID | 异步任务响应头 | 头级任务关联 |
| 您自己的作业/用户 ID | 您的应用程序 | 将 TokenLab 活动与用户工作流关联 |
记录内容
记录足够的信息以诊断请求而不泄露机密：- 端点、HTTP 方法、模型、状态码、时间戳和延迟。
- 公共标识符：
request_id、task_id、poll_url和billing_transaction_id（如存在）。 - 清理后的请求形状：哪些字段存在，而不是完整的提示或私有媒体内容。
- 终端异步状态响应，包括公共错误字段。
- 客户端重试计数以及重试是否创建了新任务或恢复了现有任务。
Authorization、API 密钥、管理令牌、签名 URL、私有媒体 URL、完整提示和用户个人数据。
故障排除矩阵
使用对账
使用管理 API 进行服务器端对账：GET /v1/management/api-keys/{keyId}/usage 可以按 scene、accessChannel、logicalModel、modelVendor、startDate 和 endDate 进行过滤。使用这些记录，而不是抓取仪表板页面或依赖上游供应商任务 ID。
流式响应可能在流发送后结算，因此即使使用稍后记录，计费头也可能缺失。异步媒体任务可能在终端轮询后结算。
支持包模板
联系支持时，请包括：request_id。- 异步工作的
task_id和poll_url。 - 如果存在，包含
billing_transaction_id。 - 端点、方法、模型、时间戳和状态码。
- 清理后的请求形状和公共错误主体。
- 您期望的结果和用户实际看到的内容。
操作检查
- 对重复的
401、402、429和5xx响应单独发出警报；它们通常有不同的负责人。 - 跟踪在您的产品 SLA 之上仍然非终端的异步作业。
- 跟踪同一用户作业 ID 的重复创建尝试。
- 采样已完成的作业，并验证用户可见资产、使用记录和存储的任务记录是否一致。
API 参考
| 主题 | 参考 |
|---|---|
| 错误处理 | 错误处理 |
| 速率限制 | 速率限制 |
| 计费与定价 | 计费与定价 |
| 获取 API 密钥使用情况 | 获取 API 密钥使用情况 |
| 获取任务状态 | 获取任务状态 |