排查 Genesis API 调用问题

从可观察到的响应和当前代码生成器开始排查。不要通过拼接内部路由、替换未确认的认证头或猜测字段来“修复”请求。

现象

检查

下一步

401

PAT 或服务账号 Key 是否完整；是否使用 Bearer 认证头

从 Genesis 使用页重新复制示例；必要时轮换凭据

403

模型是否对当前凭据可见；账号或服务账号是否有权限

用 GET /models 检查可用模型，再检查控制台权限和策略

404

Base URL、版本段和接口路径是否与使用页示例一致

不要手动增删 /v1；重新复制该接口示例

429

同一凭据的并发、速率或额度是否达到限制

按限流与重试降低压力并退避

5xx 或网络错误

是否为临时失败；请求是否可安全重试

有限重试；保留请求 ID 和时间范围

返回结构不同

模型和接口是否切换；是否使用了过期 SDK 示例

对照当前使用页和参考页，删除猜测字段

提交排障信息

向支持或服务负责人提供以下脱敏信息：

  • 发生时间和时区；

  • Base URL 的路径形态，不含私有域名或 token；

  • 接口、模型 ID、HTTP 状态和请求 ID；

  • 经过脱敏的响应正文；

  • 使用的 SDK 版本或 cURL 请求；

  • 已完成的检查和重试次数。

不要附上完整 API Key、PAT、数据库密码或包含业务敏感数据的完整提示词。

最后更新于