常见 HTTP 状态
下表是通用排查方向，不构成 llm.sg 完整错误码定义。平台或上游可能使用不同状态码，优先阅读实际错误消息。“未提供令牌”怎么办？
确认请求中包含以下请求头：GET https://api.llm.sg/v1/models 的无密钥检查确实返回了 401 和“未提供令牌”。该检查只验证了此端点的鉴权要求。
Base URL 应该填写什么？
API 域名为https://api.llm.sg。本稿的兼容 SDK 示例填写 https://api.llm.sg/v1；直接调用对话接口的完整地址为 https://api.llm.sg/v1/chat/completions，后者仍需完成接口验证。
第三方应用可能自动追加 /v1。根据它的配置说明和实际请求 URL 排查重复路径。
模型不存在或不可用怎么办？
重新获取当前密钥可访问的模型列表，复制完整模型 ID。随后检查模型权限、账户状态及模型当前可用情况。模型在其他平台上的名称不一定能直接用于 llm.sg。从其他服务迁移要改什么？
对于兼容的文本对话接入，先调整 Base URL、API Key 和模型 ID，并用最小请求验证。再逐项验证已有的流式输出、工具、图片及结构化输出功能。其他平台的供应商路由参数或专属请求头需要单独确认，不能直接视为 llm.sg 支持。为什么没有持续输出？
检查是否启用stream，客户端是否逐块读取，以及反向代理是否缓冲响应。先在本地运行最小示例，再检查部署环境。不同模型的首段内容等待时间可能不同。
超时或限流后如何重试？
对临时网络错误、限流或部分服务端错误，可以采用有上限的指数退避并增加随机等待。认证、权限或参数错误通常需要先修正原因。 检查 SDK 是否已自动重试，避免与应用层重试叠加。超时可能发生在服务端已开始生成之后，重新请求可能产生额外消耗，也无法保证获得相同输出。反馈问题需要提供什么？
- 请求发生时间和时区。
- 接口路径与请求方法。
- 模型 ID、HTTP 状态码和脱敏后的错误消息。
- 响应中的请求 ID，例如实际返回的
x-request-id或错误消息中的 request id。 - 客户端或 SDK 版本，以及删除密钥和敏感输入后的最小复现示例。