Appearance
常见问题与报错
没成功，先按这个顺序检查
- 回到客户端设置，确认选中的是自己添加的 星空提供方。
- 回到星空 API 密钥，复制完整 Key，替换客户端密钥栏中的内容；不要输入截图里的
sk-…。 - 对照你正在使用的那篇客户端教程，重新核对地址。不同客户端是否加
/v1不同，不要混用教程。 - 有“获取模型”按钮时，重新获取，选择自己卡或套餐内的模型。
- 回到 我的订阅核对有效期和剩余额度，再发送一次“你好”。
仍然失败就保留报错，按 下面的工单步骤反馈，不必先学会所有错误码。
✅ 本节完成检查点：核对了提供方、Key、地址、模型和额度。
为什么请求失败或超时？
先用一句“你好”单次测试，不上传图片、不附带很长的历史记录。依次检查：网络 → 地址与协议 → Key → 分组/模型 → 额度 → 平台状态。
| 错误或状态 | 常见原因 | 怎么排查 |
|---|---|---|
| 400 | 参数、模型能力或协议不匹配 | 看错误说明；关闭不必要的附加参数，用短文本测试 |
| 401 | 密钥缺失、错误或失效 | 重新复制完整 Key，检查到期及启用状态 |
| 403 | 权限或来源受限 | 检查分组、模型、IP 白名单和账户状态 |
| 404 | 地址/路径错误、接口未开放，也可能是模型路由不存在 | 核对 /v1 与协议，检查模型 ID |
| 429 | 并发、频率或额度限制 | 查看错误内容和控制台用量；按提示等待，减少并发，别连续重试 |
| 500 / 502 / 503 | 网关或上游暂时异常 | 查看公告，稍后少量重试；持续失败时提交记录 |
超时 / Failed to fetch | 网络、DNS、浏览器跨域、客户端代理或上游耗时 | 换可信桌面客户端或 curl 做一次短请求，对照平台使用记录 |
HTTP 状态码只是线索，以错误正文和控制台记录为准。请求超时也不能直接认定“没执行、没扣费”，先查记录再决定是否重试。
为什么提示额度不足？
查看账户余额、订阅可用量、密钥累计额度，以及 5 小时/日/7 天金额限制。即使账户有余额，也可能达到这把 Key 的预算。调整自己设置的预算不会自动充值，也不会绕过平台限制。
为什么模型列表里没有某个模型？
可能是当前分组未开放、Key 权限不同、模型下线、客户端缓存，或列表接口未提供。先刷新，再在控制台确认模型 ID 与权限；确认可用后才能手动添加。不要只看模型广场就认定一定能调用。
中国大陆能直接用吗？
无法保证所有地区、运营商和网络都能稳定访问。先在自己的网络测试控制台与接入端点，再用短请求验证。控制台能打开不代表 API 一定可达；下载客户端和调用星空也可能经过不同网络。遇到问题查看平台公告或联系支持，不要把上游官网的可达性直接当成星空网关的结论。
Key 泄露了怎么办？
立即在控制台停用或删除旧 Key，创建新 Key，更新所有客户端和本地配置，然后查看异常用量。删除 GitHub 页面上的文件还不够，Key 可能留在提交历史、日志或缓存里，必须先让旧 Key 失效。GitHub 私有仓库也不是存放密钥的保险箱。
怎样反馈疑似扣费或技术错误？
通过控制台提供的帮助或工单渠道，提交发生时间及所在时区、客户端版本、模型 ID、错误码、请求 ID（若有）和对应使用记录。完整 Key 不要发送，截图和日志先脱敏。已核实的计费或技术错误可修正费用，具体以平台核实结果为准。
能无限并发，或者用脚本挖额度吗？
不能。星空支持正常编码和模型调用，不承诺无限吞吐量。批量脚本并发和配额挖掘会被限制。看到“无限制”通常只是未设置某一项密钥级限制，不表示平台允许无限调用。
✅ 本节完成检查点
- [ ] 我会结合错误正文、控制台记录和状态码排查。
- [ ] 我知道超时、模型列表和额度问题分别该查哪里。
仍然失败：这样提交工单
- 打开 星空控制台，点击左侧 我的工单。
- 使用页面中的新建工单入口，主题填写“客户端接入失败”。
- 复制下面的模板，将括号中的说明换成自己的信息。
- 附上报错截图。截图里遮住完整 API Key、登录密码、导入链接；只保留排查需要的设置和错误信息。
- 检查一遍内容后提交，之后回到“我的工单”查看回复。
- 客户端：（名称与版本，例如 Chatbox）
- 电脑系统：（Mac 或 Windows，以及系统版本）
- 卡或套餐名称 / 分组：（控制台中显示的名称）
- 密钥名称：（只写自己起的名字，不发 Key 内容）
- 模型 ID：（实际选择的模型）
- 出错时间：（日期、时间、时区，例如北京时间）
- 错误提示：（完整错误文字，先删除其中的凭据）
- 已检查项目：（地址、密钥、获取模型、剩余额度）
- 使用记录：（是否看到对应请求；有请求 ID 时附上）
不知道该选哪个分组时，也可以直接写：“我持有【套餐名称】，想用【客户端】，请确认应选的厂商、分组、模型 ID 和配置方式。”
✅ 本节完成检查点：知道如何把问题描述清楚，并能找到工单回复。