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

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

在应用中保留调用信息

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

信息

用途

调用时间和时区

在 Genesis 日志中按时间范围定位记录。

接口和模型 ID

区分 Chat Completions、Responses、Messages、Embeddings 或 Rerank,以及实际调用的模型。

请求 ID

关联应用中的单次调用;仅在接口实际返回该字段时记录。

HTTP 状态和脱敏错误正文

判断问题是否涉及认证、模型、请求参数、限制或服务端处理。

延迟和实际返回的用量字段

分析请求耗时和 Token 消耗;字段未返回时不要补造数值。

调用凭据的脱敏标识

区分不同应用或服务账号的调用,不能记录完整 Key。

在控制台定位调用

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

  1. 在应用日志中确认调用时间、接口、模型 ID 和调用凭据的脱敏标识。

  2. 打开 Genesis 控制台的 日志,按时间范围定位记录。需要缩小范围时,按调用凭据或来源 IP 筛选。

  3. 打开记录详情,检查页面展示的状态、耗时、Token 信息以及请求或响应摘要。

  4. 需要分析一段时间内的消耗时,打开 用量,按模型或凭据查看汇总和趋势。

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

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

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

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

处理限制和临时失败

现象

先检查

处理方式

429 或明确的限流提示

同一凭据的并发请求、当前额度和控制台中的限制配置

降低并发,并使用有限次、带随机抖动的退避重试。服务端明确给出等待时间时,优先按该时间等待。

认证或权限错误

凭据状态、认证 Header 和当前可调用模型

不要自动重试。按身份认证检查凭据,并用 获取可用模型确认模型范围。

参数或模型不匹配

接口请求格式、模型能力和错误正文

不要自动重试同一请求。修正字段,或从当前可用模型中重新选择。

5xx 或网络中断

请求是否已经返回内容、接口、模型 ID、请求 ID 和错误正文

只有业务能够识别重复结果时才进行有限重试。流式响应中断后,已收到的文本可能不完整;不要假定可以从中断位置继续。

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

下一步

最后更新于