网关运行与排障
调用失败时,先用状态码缩小范围,再凭请求 ID 核对企业日志。这里也提供实例就绪检查、文档变更和签约支持的提交方式。
按现象排查
401 / 403- 核对环境、密钥有效期、请求头、来源 IP 和模型权限。可先用同一个 Key 请求模型列表。
400 / 404- 核对 Base URL 是否重复拼接 /v1,再检查端点、模型 ID、请求体和对应能力。
402- 在企业控制台核对钱包余额、套餐可用额度及余额预检规则。
429- 如有 Retry-After,等待指定时间再重试。应用应限制重试次数,并采用带抖动的指数退避。
502 / 503 / 504- 记录请求编号并查看实例就绪状态及对应模型的调用结果。流式已输出或异步任务已提交时,先核对原请求结果再决定是否重发。
SSE- 对比客户端直连网关和经企业代理的表现。检查是否收到 SSE 事件,排除代理缓冲和读取超时。
查看实例版本和就绪状态
GET /api/public/status- 读取部署实例的 version 字段及站点信息。status 字段是公开快照中的固定标记。
GET /healthz- 由运维在部署环境检查网关进程存活。
GET /readyz- 由运维核对实例是否具备接收流量的条件。模型或渠道的可用性用对应调用验证。
提交企业支持请求
已签约企业请通过企业管理员或合同约定的支持渠道提交。提供环境、实例版本、发生时间和时区、接口路径、模型 ID、HTTP 状态、错误码和响应头中的 x-request-id(如有)。流式问题请标注是否收到首个 SSE 事件。
可附一条脱敏的最小请求。移除 API Key、登录 JWT、客户正文和个人信息。账单问题可同时附上受影响时段及对应的用量记录。
文档更新
- 增加编程工具、智能体和客户端集成指南,以及企业应用迁移、模型协议选择和排障说明。 查看工具与工作流
切换模型前,用现有 Key 确认目标 ID,核对协议与生效价,并按企业约定的变更窗口完成灰度验证。
