Base URLhttps://suoxie.codes/v1

排错

联系支持

提交可复现且已脱敏的问题信息。

联系前先做三步 ​

支持人员需要能够区分账户、API、客户端和本地网络问题。联系前先完成:

  1. 使用发生问题的同一把 Key 调用 GET /v1/models。
  2. 从实时列表复制模型 ID,执行对应接口的最小 cURL 请求。
  3. 打开 https://suoxie.codes/usage,确认目标时间段内是否有成功或失败记录。

这三步的结果比“不能用”“一直报错”更有帮助。若 Key 已泄露或出现陌生用量,先撤销并轮换,不要等待支持回复。

从哪里联系 ​

登录梭子蟹控制台,使用页面当前显示的“客服联系方式”或站点运营方公布的正式支持渠道。联系方式由后台配置,可能调整,因此不要使用搜索结果、他人转发或旧截图中的非官方账号。

联系前确认:

  • 页面域名是 https://suoxie.codes/,浏览器未提示证书异常。
  • 对方不要求提供密码、验证码、完整 API Key 或完整会话链接。
  • 远程协助前了解操作范围,不允许陌生人直接控制服务器或密码管理器。

一份可复现报告需要什么 ​

信息推荐写法
发生时间2026-08-12 14:35 Asia/Shanghai,包含日期、时间和时区
影响范围一把 Key / 一个模型 / 一个端点 / 所有请求
端点与方法POST /v1/responses,不要只写“API”
HTTP 结果状态码、错误 type/code/message 和实际出现的重试头
模型请求中使用的完整模型 ID
客户端名称、版本、操作系统;cURL 还应提供版本
Key 标识控制台中的 Key 名称,必要时只给末尾 4 位,不给完整值
复现步骤从全新终端开始的最少步骤,说明是否每次发生
已尝试/v1/models、最小请求、网络切换等结果

如果响应包含 X-Request-ID 或 X-Client-Request-ID,可以一并提供。字段未返回时写“未返回”,不要自己生成一个看似真实的 ID。

可直接使用的模板 ​

text
主题:POST /v1/responses 在指定模型上持续返回 503

发生时间与时区:<YYYY-MM-DD HH:mm 时区>
影响范围:<单个 Key / 单个模型 / 全部请求>
客户端与版本:<例如 curl 8.x / Codex 版本>
操作系统或运行环境:<系统、服务器或容器>
请求方法与端点:<例如 POST /v1/responses>
模型:<MODEL>
Key 名称 / 尾号:<名称,末尾最多 4 位>
HTTP 状态:<STATUS>
错误 type/code/message:<已脱敏原文>
请求关联 ID:<实际返回值或“未返回”>
发生频率:<每次 / 偶发,约几次中出现几次>

最小复现步骤:
1. <步骤一>
2. <步骤二>
3. <步骤三>

/v1/models 结果:<成功 / 失败及状态码>
同一 Key 的最小 cURL 结果:<成功 / 失败及状态码>
用量页是否有记录:<有 / 无,目标时间段>
已尝试:<每项操作及结果>
期望结果:<一句话>
实际结果:<一句话>

不要把占位符替换成秘密信息。请求体只保留复现所需的最小结构,业务文本改成无敏感数据的等价示例。

如何脱敏 ​

  • API Key:不发送完整值。需要区分时使用控制台 Key 名称,最多附末尾 4 位。
  • Authorization:删除整行,不能只遮住中间一段后保留可利用内容。
  • 请求内容:替换姓名、邮箱、电话号码、客户文本、代码和图片,不只打模糊马赛克。
  • URL:删除查询参数中的令牌、签名、对象存储地址和个人会话标识。
  • 截图:裁掉浏览器账号、标签页、书签、余额、订单、IP 和其他无关窗口。
  • 日志:只截取问题前后必要行,保留时间、端点、状态和脱敏错误。

兑换问题可以提供兑换发生时间、结果状态和页面显示的脱敏记录,但不要发送完整兑换码或完整订单号。

附件建议 ​

优先发送纯文本错误、脱敏 cURL 和必要日志,便于搜索和复制。截图只用于展示 UI 状态;不要用截图代替可复制的状态码与错误正文。

上传前逐个打开附件复查。压缩包、终端历史、.env、配置目录和 HAR 文件可能包含 Key、Cookie、请求正文或签名 URL,未经检查不要发送。

等待回复期间 ​

  • 保留可复现环境和时间范围,但停止高频重试。
  • 不反复创建 Key 或删除原始用量记录,以免证据无法关联。
  • 若影响生产,先降低并发、切换已验证的备用模型或执行业务降级。
  • 新增发现继续补充到同一个问题中,注明时间和改变了什么。

下一步 ​

提交前再按常见错误核对一次。问题解决后用原最小请求复测,并在 Key 用量确认结果与费用。