常见问题
以下问题覆盖接入时最常见的鉴权、模型、用量和网络排查场景。
为什么返回 401？
确认使用 ZBStream 创建的完整 API Key，并以 Authorization: Bearer <key> 发送。密钥只在创建时完整显示，已撤销密钥不能恢复。
为什么模型不存在？
先请求 GET /v1/models，使用返回的精确 id。模型可用性会随渠道和应用配置变化。
为什么控制台积分与 Token 数不同？
积分是按模型费率对输入、缓存命中和输出 Token 分别计算后的计费结果，不等于 Token 总数。
请求超时如何处理？
检查本地网络、代理和客户端读取超时。长响应建议开启 stream，并对 502、503、504 使用有限次数指数退避。