HTTP 状态与平台错误码
Fluxlane API 常见 HTTP 状态码(400、401、403、413、429、500、502、503)与平台状态码 666 的含义、常见原因和处理方法。
状态码一览
| 状态 | 原因 | 处理 |
|---|---|---|
| 400 | 模型名或参数错误 | 对照模型广场与接口格式检查,见模型、参数与协议问题 |
| 401 | API Key 错误、过期或禁用 | 检查请求头,必要时重新生成密钥,见鉴权问题 |
| 403 | 模型 / 分组 / IP 无权限,或额度不足 | 检查密钥限制与账户余额,见权限与余额问题 |
| 413 | 请求体过大(Content Too Large) | 缩小请求内容后重试,例如减少图片、文件或上下文长度 |
| 429 | 限速 / 限流 | 降低并发,指数退避,见限流处理 |
| 500 / 502 | 上游异常 | 稍后重试 |
| 503 | 无可用渠道或上游服务不可用 | 稍后重试;确认模型可用性或联系支持 |
| 666 | 网关收到上游非 200 响应 | 见下文 |
| 超时 | 生成较慢或网络中断 | 启用流式输出,提高客户端超时,见超时处理 |
666 是什么
666 是网关自定义的状态,表示网关收到了上游的非 200 响应,错误码为 bad_response_status_code。常见于模型不支持该请求,例如:
- 向
glm-5.3发送图片(该模型不接受图片); - 在
/v1/chat/completions上向gpt-6*模型发送工具调用,但没有关闭推理。
处理方法:对照厂商与模型差异和对应接口页面检查请求。报障时附上响应头 X-Oneapi-Request-Id。
报障时附上
- 响应头
X-Oneapi-Request-Id; - 状态码和完整的错误响应体;
- 请求时间、接口路径、模型名,以及脱敏后的请求内容。
提交方式见支持与反馈。