常见问题

Sublyx 支持哪些模型？

当前公开模型覆盖 Anthropic Claude、OpenAI GPT、Google Gemini 与 xAI Grok。具体模型 ID 见模型列表，实际可用范围以控制台和 /v1/models 为准。

OpenAI 与 Anthropic 的 Base URL 有什么区别？

OpenAI compatible 使用 https://api.sublyx.org/v1；Anthropic Messages 使用 https://api.sublyx.org。后者的客户端会自行拼接 /v1/messages。

为什么返回 401？

检查以下项目：

• 请求是否携带 API Key。
• Authorization 是否使用 Bearer sk-sublyx-example 格式。
• Key 是否完整、未停用且没有多余空格。
• SDK 是否在正确的进程和环境中读取了变量。

API Key 丢失了怎么办？

完整 Key 通常只在创建时显示一次。如果已经丢失，请停用旧 Key，创建新 Key，并更新所有依赖服务。

为什么返回 402？

账户余额不足。登录控制台完成充值，并确认交易和余额状态后再重试。

为什么返回 429？

当前请求频率、Token 吞吐或并发超过限制。降低并发，使用队列和指数退避；持续接近限制时再申请调整额度。

如何选择模型？

先确定质量、延迟、上下文、工具能力与成本要求，再用小规模真实任务评测。高频简单任务优先考虑轻量模型，复杂推理与长上下文任务再选择旗舰模型。

可以从浏览器直接调用吗？

不建议。浏览器无法安全保存长期 API Key。应通过你的服务端代理请求，并在服务端执行认证、配额和审计。

是否支持流式输出？

支持。OpenAI compatible 请求设置 "stream": true，并按 SSE 事件解析。详见流式响应。

如何获取页面 Markdown？

在文档 URL 后添加 .md，例如：

https://docs.sublyx.org/docs/quickstart.md

也可以使用 llms.txt 获取索引，或使用 llms-full.txt 获取全部文档正文。

仍然无法解决问题怎么办？

准备以下信息后，通过控制台提供的支持渠道联系：

• 发生时间与时区。
• 请求端点和模型 ID。
• HTTP 状态码与错误类型。
• 请求标识和可复现步骤。
• 已脱敏的请求结构。

不要发送完整 API Key、密码或未经授权的用户数据。