# 查看 Genesis 调用的用量、日志与限制

当 Genesis 模型 API 调用出现异常、用量变化或限制提示时，先在应用中保留必要的诊断信息，再到 Genesis 控制台查看日志和用量。本页只处理 Genesis 模型 API 的调用观察与恢复；控制台中的具体操作请参阅 [查看 Genesis 运行情况](../../../guides/genesis/observe.md)。

## 在应用中保留调用信息

每次请求结束后，记录能够还原调用条件的最小信息。不要记录访问令牌、完整提示词、图像数据或其他业务敏感内容。

| 信息 | 用途 |
| --- | --- |
| 调用时间和时区 | 在 Genesis 日志中按时间范围定位记录。 |
| 接口和模型 ID | 区分 Chat Completions、Responses、Messages、Embeddings 或 Rerank，以及实际调用的模型。 |
| 请求 ID | 关联应用中的单次调用；仅在接口实际返回该字段时记录。 |
| HTTP 状态和脱敏错误正文 | 判断问题是否涉及认证、模型、请求参数、限制或服务端处理。 |
| 延迟和实际返回的用量字段 | 分析请求耗时和 Token 消耗；字段未返回时不要补造数值。 |
| 调用凭据的脱敏标识 | 区分不同应用或服务账号的调用，不能记录完整 Key。 |

## 在控制台定位调用

需要确认单次失败原因或一段时间内的消耗时，按以下顺序操作：

1. 在应用日志中确认调用时间、接口、模型 ID 和调用凭据的脱敏标识。
2. 打开 Genesis 控制台的 **日志**，按时间范围定位记录。需要缩小范围时，按调用凭据或来源 IP 筛选。
3. 打开记录详情，检查页面展示的状态、耗时、Token 信息以及请求或响应摘要。
4. 需要分析一段时间内的消耗时，打开 **用量**，按模型或凭据查看汇总和趋势。

请求和响应摘要可能包含业务数据。只有获授权的人员应查看、导出或转交这些信息。

## 检查凭据的模型范围和限制

Genesis 的可调用模型范围、额度和速率限制与调用凭据相关。使用服务账号时，可以在 Genesis 产品权限中选择模型，并按需配置额度限制和速率限制；具体数值以当前凭据配置为准。

不要把控制台中的某个数值、截图中的统计结果或单个模型的价格当成所有凭据的默认限制。需要调整服务账号的模型、额度或速率范围时，请参阅 [管理 Genesis 访问凭据](../../../guides/genesis/api-keys.md)。

## 处理限制和临时失败

| 现象 | 先检查 | 处理方式 |
| --- | --- | --- |
| `429` 或明确的限流提示 | 同一凭据的并发请求、当前额度和控制台中的限制配置 | 降低并发，并使用有限次、带随机抖动的退避重试。服务端明确给出等待时间时，优先按该时间等待。 |
| 认证或权限错误 | 凭据状态、认证 Header 和当前可调用模型 | 不要自动重试。按[身份认证](getting-started/authentication.md)检查凭据，并用 [获取可用模型](getting-started/available-models.md)确认模型范围。 |
| 参数或模型不匹配 | 接口请求格式、模型能力和错误正文 | 不要自动重试同一请求。修正字段，或从当前可用模型中重新选择。 |
| `5xx` 或网络中断 | 请求是否已经返回内容、接口、模型 ID、请求 ID 和错误正文 | 只有业务能够识别重复结果时才进行有限重试。流式响应中断后，已收到的文本可能不完整；不要假定可以从中断位置继续。 |

`5xx` 不一定表示临时故障。例如，模型可能不支持当前接口中的图像输入或工具调用。先保留脱敏的请求信息和错误正文，再用相同模型与接口发送更小的请求确认。问题持续出现时，改用已验证的模型或调用方式，不要反复重试。

## 下一步

- [在控制台查看用量、日志和通知](../../../guides/genesis/observe.md)
- [调整服务账号的模型、额度和速率范围](../../../guides/genesis/api-keys.md)
- [获取当前凭据可调用的模型](getting-started/available-models.md)