常见问题
账号与密钥
Q：密钥忘了／丢了怎么办？ 找不回来。服务端只存哈希，连管理员也看不到明文。去控制台把这个令牌删了，重新建一个。
Q：能一个密钥用在所有项目吗？ 技术上可以，但不建议。按项目拆开，哪个泄露了就只删那一个，用量也好分开看。
Q：密钥泄露了会怎样？ 别人可以拿它调模型，扣的是你的额度。发现后立刻删除令牌（不是禁用），再建新的。已产生的消耗不退还。
Q：怎么限制某个密钥只能用某些模型？ 控制台建令牌时，在「模型限制」里填允许的模型列表。
调用相关
Q：报 404 model not found，但模型名明明写对了？ 两种可能：① 你的分组没开通这个模型，用 /v1/models 看返回里有没有它；② 模型刚下线。
Q：中文乱码怎么办？ 确保按 UTF-8 处理。流式场景下要按完整事件切分，别按字节切——中文是多字节的，切断了就乱。
Q：返回内容被截断了，finish_reason 是 length？ 达到 max_tokens 上限了。调大这个值，或者在提示词里要求它控制篇幅。
Q：模型说不知道今天发生的事？ 模型的训练数据有截止时间。新消息、新版本、新价格它不知道，要么开联网搜索（如果用的模型支持），要么你自己把相关内容贴给它。
Q：为什么同样的 prompt，每次回答都不一样？ 模型是概率采样。要稳定就降 temperature（比如 0.2 或 0），但降到 0 也不是百分百确定。
Q：一个 token 大概多少个汉字？ 中文大约 1 个汉字 ≈ 1.5~2 token，英文大约 1 个单词 ≈ 1.3 token。准确数字看响应里的 usage。
Q：并发调用会不会被封？ 不会封，但会 429。控制在 5-10 并发比较稳，别开上百个线程。
计费
Q：怎么知道一次调用花了多少钱？ 响应里的 usage 有 token 数，配合控制台的「模型价格」算出金额。控制台也会汇总每次调用的消耗。
Q：额度用完了会怎样？ 返回 403 insufficient_quota。充值后立即恢复。
Q：为什么只问了一句话却扣了很多 token？ 通常是带上了历史对话。多轮对话每轮都要把前面全部发过去，token 数会累加。
Q：流式返回没有 usage 怎么办？ 加 "stream_options": {"include_usage": true}，最后会多推一个含 usage 的 chunk。
稳定性
Q：为什么偶尔报 502 / 530？ 上游服务商那边抖了。网关会自动重试 3 次，还失败才报给你。连续超过 10 分钟说明上游真的挂了，联系我们。
Q：524 是什么？ 上游超过 120 秒没返回，被 Cloudflare 掐断了。这个码不会自动重试——已经等了两分钟，再等一轮没意义。缩短输入或换个模型试试。
Q：服务有 SLA 吗？ 没有。不承诺 100% 可用性，也不承诺响应时间。重要业务请自己做降级和备用方案。
Q：支持退款吗？ 已消耗的额度不退。未消耗的部分，充值后 7 日内联系我们，扣除支付渠道手续费后退还。
数据和隐私
Q：我的 prompt 会被拿去训练吗？ 不会。我们不训练模型，也没有模型。
Q：prompt 会离开你们服务器吗？会。 这是网关的工作方式——你的请求要转发给上游模型厂商才能得到回答，第三方怎么处理适用他们自己的隐私政策。
别在 prompt 里放敏感信息
身份证号、银行卡、密码、客户名单、合同原文——这些不要往提示词里贴。不只是我们，上游厂商也会看到。
Q：能保证数据不外泄吗？ 我们不能控制上游厂商的行为。如果你处理的是真正敏感的数据，唯一可靠的做法是不要用云端 API，自己本地部署模型（参见我们那本《AI 编程指南》里「公司内部署」那一章）。
还是没解决
把这几样发到交流群（QQ 群 956766495）或者写信：
- 状态码 + 完整错误 JSON
- request id
- 大致时间
- 你用的什么客户端 / SDK
只发一句「报错了」帮不上忙——日志里几百条请求，没线索找不到你那一条。
邮箱：cyan714@outlook.com、xyymc_666@qq.com