查看 Genesis 调用的用量、日志与限制¶
当 Genesis 模型 API 调用出现异常、用量变化或限制提示时,先在应用中保留必要的诊断信息,再到 Genesis 控制台查看日志和用量。本页只处理 Genesis 模型 API 的调用观察与恢复;控制台中的具体操作请参阅 查看 Genesis 运行情况。
在应用中保留调用信息¶
每次请求结束后,记录能够还原调用条件的最小信息。不要记录访问令牌、完整提示词、图像数据或其他业务敏感内容。
信息 |
用途 |
|---|---|
调用时间和时区 |
在 Genesis 日志中按时间范围定位记录。 |
接口和模型 ID |
区分 Chat Completions、Responses、Messages、Embeddings 或 Rerank,以及实际调用的模型。 |
请求 ID |
关联应用中的单次调用;仅在接口实际返回该字段时记录。 |
HTTP 状态和脱敏错误正文 |
判断问题是否涉及认证、模型、请求参数、限制或服务端处理。 |
延迟和实际返回的用量字段 |
分析请求耗时和 Token 消耗;字段未返回时不要补造数值。 |
调用凭据的脱敏标识 |
区分不同应用或服务账号的调用,不能记录完整 Key。 |
在控制台定位调用¶
需要确认单次失败原因或一段时间内的消耗时,按以下顺序操作:
在应用日志中确认调用时间、接口、模型 ID 和调用凭据的脱敏标识。
打开 Genesis 控制台的 日志,按时间范围定位记录。需要缩小范围时,按调用凭据或来源 IP 筛选。
打开记录详情,检查页面展示的状态、耗时、Token 信息以及请求或响应摘要。
需要分析一段时间内的消耗时,打开 用量,按模型或凭据查看汇总和趋势。
请求和响应摘要可能包含业务数据。只有获授权的人员应查看、导出或转交这些信息。
检查凭据的模型范围和限制¶
Genesis 的可调用模型范围、额度和速率限制与调用凭据相关。使用服务账号时,可以在 Genesis 产品权限中选择模型,并按需配置额度限制和速率限制;具体数值以当前凭据配置为准。
不要把控制台中的某个数值、截图中的统计结果或单个模型的价格当成所有凭据的默认限制。需要调整服务账号的模型、额度或速率范围时,请参阅 管理 Genesis 访问凭据。
处理限制和临时失败¶
现象 |
先检查 |
处理方式 |
|---|---|---|
|
同一凭据的并发请求、当前额度和控制台中的限制配置 |
降低并发,并使用有限次、带随机抖动的退避重试。服务端明确给出等待时间时,优先按该时间等待。 |
认证或权限错误 |
凭据状态、认证 Header 和当前可调用模型 |
|
参数或模型不匹配 |
接口请求格式、模型能力和错误正文 |
不要自动重试同一请求。修正字段,或从当前可用模型中重新选择。 |
|
请求是否已经返回内容、接口、模型 ID、请求 ID 和错误正文 |
只有业务能够识别重复结果时才进行有限重试。流式响应中断后,已收到的文本可能不完整;不要假定可以从中断位置继续。 |
5xx 不一定表示临时故障。例如,模型可能不支持当前接口中的图像输入或工具调用。先保留脱敏的请求信息和错误正文,再用相同模型与接口发送更小的请求确认。问题持续出现时,改用已验证的模型或调用方式,不要反复重试。