常见问题

Nexly API 可以直接使用 OpenAI SDK 吗？

可以。把 SDK 的 Base URL 修改为 https://nexly.guangnian.xin，并使用 Nexly API Key 和 /v1/models 返回的模型 ID。完整示例见 OpenAI SDK。

Nexly API Base URL 要不要带 /v1？

不需要。SDK、CC Switch 和客户端统一填写 https://nexly.guangnian.xin，Nexly API 会自动识别接口。只有直接发送 HTTP 请求或客户端明确要求“完整接口 URL”时，才填写 /v1/models、/v1/chat/completions 等完整路径。详见客户端配置。

为什么示例模型无法调用？

模型名称只用于展示请求结构。调用 GET /v1/models 或登录控制台查询当前账号可用模型，并把返回的 id 原样填入 model。

模型列表能获取，但聊天仍失败？

模型列表只证明 Key 和基础服务正常。继续确认模型是否支持 /v1/chat/completions、/v1/responses 或当前客户端使用的其他协议。

API Key 应该放在哪里？

放在服务端环境变量、CI/CD Secret 或密钥管理服务中。不要提交到 Git，不要写入公开网页，也不要打包进客户端应用。详细建议见身份认证。

为什么返回 401？

检查请求头是否为 Authorization: Bearer YOUR_API_KEY，注意 Bearer 后有一个空格，并确认 Key 没有被删除、禁用、过期或复制不完整。

为什么返回 429？

可能是请求频率超过限制、并发过高、账号额度不足或上游渠道限流。请先查看完整错误消息和控制台用量，再决定是否重试。

支持流式输出吗？

支持流式输出的模型可以设置 "stream": true。cURL 测试时使用 -N。不同模型的能力以实际请求结果为准。

为什么流式响应一次性返回？

客户端或反向代理可能缓冲了 SSE 响应。先使用 curl -N 直连测试，再检查 Nginx、网关或客户端的响应缓冲设置。

可以在浏览器前端直接调用吗？

不建议。浏览器会暴露 API Key，并可能受到 CORS 限制。生产项目应由自己的服务端保存 Key 并代理请求。

在线调试会保存 API Key 吗？

API Reference 不会把新输入的 Key 持久保存到浏览器；密钥仅在当前页面的调试会话中使用。切换外观、刷新或离开本页会重置调试输入，也可以点击 清除认证信息立即重置。

打开页面时会尝试移除本站旧版本 Scalar 文档保存的认证，不会清空其他站点偏好。若浏览器禁止访问存储，页面会提示通过浏览器的站点数据设置清理历史认证。请避免在共享设备使用长期 Key；清除本页认证不会撤销密钥，泄露后仍需到控制台禁用或删除。

反馈问题需要提供什么？

请提供请求时间、状态码、错误响应、接口路径、模型 ID、SDK 或客户端版本，以及响应头中的请求 ID。不要提供完整 API Key。详情见错误处理。