三个求助入口
按问题的性质选入口,比全部塞进邮件更快。
第一步:先自查这五类情况
九成以上的「调用失败」都能在下表里定位。找到对应的行,按处理建议操作即可。
| 现象 | 常见原因 | 处理建议 |
|---|---|---|
401invalid_api_key |
令牌复制时带了空格、写错前缀、或已在控制台被删除/禁用。 |
确认请求头是 Authorization: Bearer sk-...(Bearer 后有且仅有一个空格)。
到控制台「令牌」页看该令牌状态,必要时重建一个(删除即时生效)。
|
402insufficient_quota |
余额或订阅额度已用尽。 | 充值后立即恢复,不用重启客户端、也不用重建令牌。 |
429rate_limit_exceeded |
触发了速率或并发限制。 | 按指数退避重试(首次 1 秒、逐次翻倍、最多 3 次), 不要立即密集重试。长期需要更高额度请看下方流程。 |
5xx / 上游超时 |
上游模型服务商侧异常。 | 先看状态页。若状态页无异常,把请求 ID 与报错原文发邮件, 这类请求不计费。 |
| 连不上 / 证书错误 | base_url 写错,或写法重复(如 /v1/v1)。 |
确认地址形如 https://api.xu55.cn/v1,用 HTTPS,
路径里只有一个 /v1。可先用下方命令验证连通性。
|
一条命令验证连通性
它同时检验域名解析、证书、鉴权与余额四项,是最小可复现的探针:
curl -sS https://api.xu55.cn/v1/models \
-H "Authorization: Bearer sk-你的令牌"
正常应返回模型列表 JSON。若这一步就失败,问题在账号或网络层面, 与你的应用代码无关。
id)、
出错时间(含时区)、以及上面这条命令的完整输出。
缺了这些,第一轮回复大概率只能先向你索要它们。
第二步:按类查常见问题
账号与登录
忘记密码怎么办?
在登录页使用「忘记密码」,系统会向注册邮箱发送重置链接。 邮件未能送达时(部分邮箱会拦截),请直接发邮件联系我们,附上账号 ID 与能证明归属的信息, 由人工核验后协助重置。
若邮箱本身已经无法使用,请用邮件联系我们,附上账号 ID 与能证明归属的信息 (例如最近的订单号),我们会人工协助。
一个账号可以给多个项目用吗?
可以,但建议按项目或环境分别创建令牌。 好处是:用量可以分开统计,某个令牌泄露时只吊销那一个, 不会牵连其他项目。
令牌在控制台「令牌」页创建,额度与过期时间都可以单独设置。
充值与计费
充值后多久到账?
支付成功后通常即时到账,刷新控制台即可看到余额变化。
如果超过 15 分钟仍未到账:请不要重复支付, 把订单号发邮件给我们核对。重复支付可以退(依 服务条款第三条),但会多出一次手续费与等待。
余额会过期吗?
充值余额不会过期,用完为止。
包月订阅的额度按月发放、每月重置,未使用的部分不结转至下月。 两者在控制台里是分开显示的。
为什么实际扣费和我预估的不一样?
常见原因有三个,按出现频率排列:
- 输入与输出的单价不同,输出通常更贵,长回答会比预想的花更多。
- 多轮对话会把历史消息整体再发一次,上下文越长输入 token 越多。
- 所在分组的倍率会乘在单价上,切换分组会改变计费系数。
控制台「日志」页可以按时间、模型、令牌逐条查看每次调用的 token 用量与费用,这是最权威的对账依据。
请求失败了,会扣费吗?
不会。只有成功完成的请求才产生费用。
鉴权失败、参数错误、上游返回错误(含模型超时、内容被上游拒绝) 这几种情况都不计费。若你发现日志里有失败请求被扣了费,请把请求 ID 发我们, 核实后原额退回。
有并发和速率限制吗?
有,默认值公开在接入文档的速率限制一节。
超限时返回 429,并给出重置时间。
需要更高额度请看下方的「申请提升配额」流程。
调用与报错
支持流式输出吗?
支持。请求里设置 stream: true,响应会以 SSE 逐块返回,
以 data: [DONE] 结束。
完整的对接示例见接入文档。
必须用你们的 SDK 吗?
不需要,也没有专用 SDK。接口兼容 OpenAI 规范,
OpenAI 官方的各种语言 SDK 都可以直接用,把
base_url 指向我们的地址即可。
理论上任何能发 HTTP 请求的语言都能接入。
回答被截断了,是为什么?
通常是 max_tokens 设置过小,或模型自身的上下文窗口已接近上限。
把 max_tokens 调大试试;如果响应里的
finish_reason 是 length,基本可以确认是这个原因。
token 数量是怎么算的?
按模型的分词器实际切分结果计算,不同模型不完全一致。 中文大致每个汉字 1 至 1.5 个 token,英文大致每 4 个字符 1 个 token, 这些只是粗略换算,不能用来精确对账。
唯一权威的数字是响应体 usage 字段里的值,扣费也以它为准。
发票与退款
可以开发票吗?
可以,开具电子发票。充值或订阅成功后,按下方 发票流程申请即可,一般 3 个工作日内完成。
如需增值税专用发票,请在邮件里说明并提供开票信息与相关资质, 我们会按实际能否开具给你明确答复,不会先收钱后拖着。
余额可以退吗?
退款多久能到账?
我们处理完退款后会按原支付渠道退回。到账时间由支付渠道决定, 通常为 1 至 7 个工作日,具体以渠道实际处理为准。
如果超过 7 个工作日仍未到账,请把退款确认邮件一并回复, 我们向渠道发起查询。
数据与安全
我的对话内容会被保存吗?
仅保留计费必需的元数据(时间、模型、用量), 不对请求正文做业务性留存, 也不使用你的请求内容或模型输出训练任何模型。
详情见隐私政策。
令牌泄露了怎么办?
按顺序做三件事:
- 到控制台「令牌」页立即删除该令牌,删除即时生效。
- 查看「日志」页,确认有无不是自己发起的调用。
- 如果发现异常消耗,把时间区间发我们,我们协助核查并处理。
另外请确认令牌没有写到前端代码、公开仓库或客户端安装包里—— 打包进前端的密钥等同于公开。
你们会查看我的请求内容吗?
不会主动查看。只有在两种情况下才可能接触到必要信息: 你主动提出故障排查请求,或依法律法规要求配合调查。
需要提醒的是:请求要获得回复,就必须转发给上游模型服务商, 这是服务成立的必要环节。因此请不要在请求中提交身份证号、银行卡号、 密码等敏感个人信息;若业务确需处理,建议先做脱敏。
第三步:四类事务的办理流程
申请退款
先核对可退金额
在控制台确认当前未使用余额。已消耗额度不可退(依 服务条款第三条); 包月订阅额度:订阅期内已发放的不单独退款,订阅生效前取消的按未使用金额退回。 核对后你心里有数,也方便比对我们的答复。
发邮件提出申请
收件人 support@xu55.cn,注明:账号 ID、注册邮箱、
充值时间与订单号、退款原因。
我们核对并回复
确认账号是否有违反可接受使用政策的记录,并计算扣除渠道手续费后的金额, 邮件回复确认。即使账号因违规被终止,未消耗的余额仍按条款退还; 若某一笔无法退款,会写明依据的条款而不是含糊带过。
按原路退回
确认后按原支付渠道退回,到账时间为 1 至 7 个工作日,以渠道实际处理为准。
申请发票
发邮件提供开票信息
需要:发票抬头名称、纳税人识别号、接收邮箱,以及对应的订单号或充值时间。
我们核对订单
核对金额与实际到账记录,如有不符会先与你确认再开票。
开具并发送
电子发票发送到你指定的邮箱,一般 3 个工作日内完成。
申请提升并发 / 速率配额
发邮件说明用途
请写明:业务场景、预计峰值 QPS 或并发数、集中在哪个时段、大致会用到哪些模型。
我们评估
依据你的实际用量与稳定运行记录,结合上游通道的承载情况判断。 说清楚用途和峰值,比只说「我要更高额度」更容易通过。
答复结果
无论是否调整都会回复。通过后即时生效,不需要你改代码或换令牌。
申诉:内容被拦截或账号被限制
发邮件申诉
附:账号 ID、发生时间、请求 ID、以及你认为属于误判的理由。 有原始请求内容的话一并附上,便于复核。
我们复核记录
比对网关侧的调用记录与上游返回的错误信息,确认拦截发生在哪一层。
答复与处置
确属误判的,恢复服务并说明原因;确属违规的,会告知所依据的条款与处置期限。 两种情况都会给明确结论。
响应时间
下表是我们对处理时间的自我约束,写下来是为了可以被对照检查。
计时口径:以下时间均以 GMT+8 计算。「工作日」指周一至周五,不含法定节假日; 计时只在服务窗口(工作日 9:00–18:00)内进行,非工作时间收到的邮件 从下一个工作日 9:00 起算——周五晚上发出的邮件,从周一早上开始计时。
| 事项 | 通道 | 期望响应时间 |
|---|---|---|
| 一般咨询、账号与账单问题 | 邮件 | 1 个工作日内 |
| 服务故障、计费异常 | 邮件(标题注明「紧急」) | 随时(由监控告警触发) |
| 退款与发票 | 邮件 | 3 个工作日内给出处理结论 |
| 配额调整评估 | 邮件 | 3 个工作日内答复 |
| 服务状态与故障公告 | 状态页 | 状态变更时更新 |
如果出现大面积上游故障,我们的处理与公告会集中在状态页, 这时请优先关注状态页,而不是等待邮件回复——那段时间里每一封回信都会变慢。
违规内容举报
举报违法违规内容
若你发现有人通过本站生成或传播违法违规内容,请发邮件至 report@xu55.cn,附上时间、账号或请求 ID 等可核查的信息。 我们会在核实后处置。
涉及违法犯罪线索的,也可以直接向公安机关或网信部门举报。
还是没解决?
发邮件到 support@xu55.cn, 并把上面提到的信息一次给全:
- 账号 ID(控制台可查)
- 请求 ID 与出错时间(含时区)
- 完整报错原文,不要只截图一句话
- 最小复现命令的输出
信息齐全的邮件,通常一轮就能给出结论; 缺信息时第一轮只能先来问你要,实际处理时间会翻倍。