常见问题与错误排查

401：认证失败

检查是否使用本站 API 密钥、复制是否完整，以及密钥是否启用、过期或额度不足。不要把管理令牌当作 API 密钥。

403：权限不足

检查密钥的分组和模型限制。内容员工不能调用模型 API；专用分组可能限制客户端类型。

400：模型未发布或分组不匹配

模型名称需要完全匹配。查看模型广场与密钥分组，确认型号在同一个分组。

404：地址或接口不支持

检查 /v1 是否重复。当前主要入口为 chat/completions、responses、responses/compact、messages、images/generations；图片编辑及 Responses 服务端读取/删除/取消入口尚未实现。

429、503 或上游错误

可能是并发、上游资源池或临时不可用。降低并发，隔一段时间重试，并查看消费明细，避免无上限自动重试。

流式中断

检查网络、客户端超时及服务器代理是否缓冲事件。保存请求 ID、时间、模型和分组给管理员排查；不要发送完整密钥。

价格和余额看起来不同

文字价格通常按每 100 万 tokens 展示，一次对话按实际输入和输出量计费。美元是官方折扣比较单位，账户实际扣费显示积分。