常见问题

密钥

密钥丢了能找回吗? 不能。服务端只存哈希,客服那里也没有。丢了就轮换一把新的 —— 轮换会给旧密钥 一个宽限期,方便你逐个把服务切过去。

密钥是对的,但一直 401? 先查来源 IP。如果这把密钥配了 IP 白名单,从名单外调用返回的是 401 invalid_api_key —— 和「密钥无效」完全同一个码。这是有意的: 专用错误码等于告诉捡到密钥的人「key 是好的,只是网络不对」。

同时能有几把密钥有效? 你可以建多把。但轮换产生的新旧两把最多同时两把 —— 宽限期内再轮换一次,更早的那把会立刻失效,不会等它自己的宽限期走完。

调用

模型下拉是空的 / 客户端说连不上? 客户端在拉 GET /v1/models。这个接口在密钥无效或余额为负时同样会失败, 先按「错误码与限流」排一遍。另外有些客户端要重启才会重新解析地址。

支持图片、语音、文件吗? 不支持。对客网关只有三个端点,见「端点与鉴权」。

流式中途断了,要重试吗? 新开一个请求,没有续传语义。注意已经生成的 token 照常计费 —— 网关按实际生成量记账,不按你收到了多少。

SDK 超时自动重试,会重复扣费吗? 会。网关不做跨请求去重(与 OpenAI 官方对这个端点的行为一致): 自动重试会被当成一次全新调用,产生第二次真实扣费。 如果你的 SDK 默认开着自动重试,建议按你的场景调低或关掉。

某个模型标着「暂不可用」? 现在没有上游能服务它。它会自己恢复,不需要开工单,要紧的活换一个模型即可。

钱

账单比我估的高不少? 多半是只按输入价估的。现网所有模型的输出价是输入价的 3 到 5 倍, 写长文、写代码这类输出重的场景差得尤其远。分两段各算一次。

支付成功了,余额没动? 别重复付款。 等几分钟再刷新;仍然没到就开工单并带上订单号 —— 每一笔发放我们都留了同步记录,客服能查到它卡在哪一步。

有后付费或信用额度吗? 没有,而且这是产品决定不是"还没做"。理由见「计费口径」。

有自动充值吗? 目前没有自动充值。余额低于阈值时控制台会给你一条通知,但补款要你自己来。

能退款吗? 未消费的余额可以,已产生的调用费用不退。可退金额由系统核算 —— 赠送和优惠券抵扣的部分不参与。见「充值与退款」。

报障

开工单要带什么? request_id、发生时间、用的模型、完整的错误响应体。 没有 request_id 我们查不到那一笔 —— 网关每天的调用量很大。

不要在工单里贴密钥明文。 排查从来不需要它。