网关 HTTP 状态码
下表描述当前 Best Jev AI /v1/systemone 网关生成的响应。Provider 故障会映射为 502；provider 自身状态码不会原样作为网关状态返回。
- 400 — JSON 无效、缺少 model 或 questions 对象、问题为空、问题超过 8 个或问题类型不支持。修正请求后再发。
- 401 — API key 缺失或无效，或 Playground 没有登录会话。检查 Bearer 格式和密钥状态。
- 402 — API 账户余额不足。购买额度或改用余额有效的账户。
- 413 — 序列化请求体超过 32 KiB。删去无关 state 或缩减字段。
- 502 — Provider 拒绝请求、返回无效结果、缺少用量数据或无法连接。检查请求；只有在工作流可安全重复时才谨慎重试。
- 503 — 此部署未配置决策 Provider。请联系站点运营方。
只重试可能恢复的故障
不要原样重试 400、401、402 或 413：相同请求仍会失败。遇到暂时性的 502，可使用带随机抖动的有限指数退避，并限制尝试次数。此 POST 接口没有幂等键，因此要先确认重复评估不会造成工作流副作用。
- 设置请求超时，并限制最大尝试次数。
- 高影响或不确定的判断应保留人工复核路径。
- 记录状态码和安全的错误摘要；不要记录 API key 或无关个人数据。
已登录的 Playground 浏览器会话在不携带 Bearer API key 时每 3 秒最多请求一次。这不是 API key 接口承诺的速率限制。