日志功能
用请求记录确认调用是否到达平台，并从状态、模型、用量和时间线定位异常。
日志是排查接入问题的第二个入口：先在客户端保留状态码和错误信息，再到控制台确认请求有没有到达 Toodoo AI。日志只能帮助核对平台侧记录，不是客户端完整聊天记录的备份。
查看和筛选记录
在控制台打开日志页面，根据页面提供的筛选项缩小范围：
- 先确认页面显示的时区。
- 将时间范围设为请求前后几分钟。
- 优先按模型、密钥或状态筛选。
- 如果使用了不同类型的请求，再切换普通、绘图或任务日志等分类（若当前站点提供）。
“没有匹配记录”只表示当前筛选条件下没有可见结果，可能是时区、密钥或时间范围不对。先清空筛选再重新定位。
重点查看哪些字段
| 字段 | 用来确认什么 |
|---|---|
| 时间 | 是否与客户端报错发生在同一时刻。 |
| 模型 | 实际发送的完整模型 ID，是否被客户端替换或映射。 |
| 密钥提示 | 哪一枚密钥发起了调用；通常只显示部分标识，不会展示完整密钥。 |
| 状态码 | 区分认证、权限、参数、限流和上游错误。 |
| 用量与消耗 | 结合模型和分组理解实际成本，不要只按客户端字符数估算。 |
| 请求标识 | 向支持人员描述同一次调用时使用；分享前检查是否包含敏感内容。 |
具体字段和可见范围以当前账号、日志类型和平台配置为准。
一次失败请求的排查流程
1. 记录客户端信息
保存工具名称及版本、发生时间和时区、HTTP 状态码、完整模型 ID、脱敏后的错误信息，以及客户端提供的请求标识。
2. 判断是否到达平台
在日志中搜索对应时间和密钥。没有记录时，先检查网络、代理、TLS、DNS、Base URL 和客户端超时；不要立即重复发送可能产生费用的请求。
3. 对照密钥与分组
有记录但返回 401/403 时，检查密钥启用状态、有效期、分组、模型限制和 IP 白名单；返回 404 时检查路径和模型 ID。
4. 用最小请求复现
将输入缩短为一句话，使用5 分钟示例重新请求。基础请求成功后，再逐项恢复长上下文、图片或工具参数。
日志中看不到调用
常见原因包括：
- 请求在 DNS、代理、TLS 或客户端网络层失败；
- Base URL 指向了控制台页面、旧域名或错误端口；
- 工具自动拼接路径，导致实际地址出现
/v1/v1； - 请求使用的不是你正在筛选的密钥或账号；
- 日志时间范围和本地时区不一致。
如果日志中有记录但客户端超时，请注意上游可能已经开始执行；不要在无法判断执行状态时无限重试，以免造成重复调用。
分享排障信息
可以提供工具版本、时间、状态码、模型 ID、脱敏错误和请求标识。必须删除 API 密钥、Cookie、完整 Authorization 头、完整请求体中的敏感内容和私人地址。
更多状态码和重试建议见错误码与排障。