首页/帮助与支持

帮助与支持

先说结论:本站绝大多数问题不必等回复。下方按「先自查 → 查常见问题 → 走流程 → 联系我们」 的顺序排列,前两步能解决绝大多数情况。

最近更新:____年__月__日

三个求助入口

按问题的性质选入口,比全部塞进邮件更快。

邮件支持

需要人工处理的一切事务:退款、发票、配额调整、计费异常、 申诉与误判复核。

1 个工作日内回复

support@xu55.cn

服务状态页

怀疑是我们的问题之前,先看一眼这里。上游故障、 维护窗口与历史事件都记录在此。

公开可查

查看服务状态

控制台自助

余额、逐条调用明细、令牌状态、订阅额度都可以自己查, 不用等人回信。

随时可用

进入控制台

本站目前不提供在线工单与实时在线客服,人工支持统一走邮件。 这样做的原因是:邮件有完整时间线,一旦发生争议,双方手里都有同一份记录。

第一步:先自查这五类情况

九成以上的「调用失败」都能在下表里定位。找到对应的行,按处理建议操作即可。

现象常见原因处理建议
401
invalid_api_key
令牌复制时带了空格、写错前缀、或已在控制台被删除/禁用。 确认请求头是 Authorization: Bearer sk-...(Bearer 后有且仅有一个空格)。 到控制台「令牌」页看该令牌状态,必要时重建一个(删除即时生效)。
402
insufficient_quota
余额或订阅额度已用尽。 充值后立即恢复,不用重启客户端、也不用重建令牌。
429
rate_limit_exceeded
触发了速率或并发限制。 按指数退避重试(首次 1 秒、逐次翻倍、最多 3 次), 不要立即密集重试。长期需要更高额度请看下方流程。
5xx / 上游超时 上游模型服务商侧异常。 先看状态页。若状态页无异常,把请求 ID 与报错原文发邮件, 这类请求不计费。
连不上 / 证书错误 base_url 写错,或写法重复(如 /v1/v1)。 确认地址形如 https://api.xu55.cn/v1,用 HTTPS, 路径里只有一个 /v1。可先用下方命令验证连通性。

一条命令验证连通性

它同时检验域名解析、证书、鉴权与余额四项,是最小可复现的探针:

cURL
curl -sS https://api.xu55.cn/v1/models \
  -H "Authorization: Bearer sk-你的令牌"

正常应返回模型列表 JSON。若这一步就失败,问题在账号或网络层面, 与你的应用代码无关。

发邮件时请一并附上:账号 ID、请求 ID(响应头或返回体中的 id)、 出错时间(含时区)、以及上面这条命令的完整输出。 缺了这些,第一轮回复大概率只能先向你索要它们。

第二步:按类查常见问题

账号与登录

忘记密码怎么办?

在登录页使用「忘记密码」,系统会向注册邮箱发送重置链接。 邮件未能送达时(部分邮箱会拦截),请直接发邮件联系我们,附上账号 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_reasonlength,基本可以确认是这个原因。

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 个工作日内答复
服务状态与故障公告状态页状态变更时更新
以上是常规情况下的期望时间,不构成带有赔付条款的服务等级协议(SLA)。 本站目前不提供这类 SLA;如果你有明确的可用性要求或采购流程需要, 请在邮件中说明场景与用量,我们单独评估后再答复能否承接。

如果出现大面积上游故障,我们的处理与公告会集中在状态页, 这时请优先关注状态页,而不是等待邮件回复——那段时间里每一封回信都会变慢。

违规内容举报

举报违法违规内容

若你发现有人通过本站生成或传播违法违规内容,请发邮件至 report@xu55.cn,附上时间、账号或请求 ID 等可核查的信息。 我们会在核实后处置。

涉及违法犯罪线索的,也可以直接向公安机关或网信部门举报。

还是没解决?

发邮件到 support@xu55.cn, 并把上面提到的信息一次给全:

  • 账号 ID(控制台可查)
  • 请求 ID 与出错时间(含时区)
  • 完整报错原文,不要只截图一句话
  • 最小复现命令的输出

信息齐全的邮件,通常一轮就能给出结论; 缺信息时第一轮只能先来问你要,实际处理时间会翻倍。