API 使用指南
常见问题
Base URL、认证、模型列表、推理显示、超时和计费的常见问题。
Base URL 要不要带 /v1？
| 客户端类型 | 填写 |
|---|---|
| OpenAI SDK 和 OpenAI 兼容工具 | https://api.lynshen.org/v1 |
| Anthropic SDK、Claude Code 和 Messages 工具 | https://api.lynshen.org |
| 要求填写完整接口地址的工具 | https://api.lynshen.org/v1/chat/completions 等完整路径 |
填错时通常会出现 404。例如，Anthropic SDK 填了带 /v1 的地址，会请求 /v1/v1/messages。
密钥正确，但返回 401
- 检查请求头：
Authorization: Bearer sk-...，Bearer后面有一个空格。或者使用x-api-key: sk-...。 - 检查密钥前后有没有多余的空格或换行。
- 在令牌管理中确认密钥已启用、没有过期。
- 密钥选择的分组与套餐的分组没有交集时，也会返回 401。
返回 403 email_unverified
登录控制台，按提示验证邮箱。验证后，原有密钥可以继续使用。
/v1/models 返回的列表是空的，或缺少某个模型
- 密钥选择了分组时，只列出这些分组中的模型。
- 密钥开启了模型限制时，只列出允许的模型。
- 账户类别不同，可用模型也不同。
- 模型广场中的模型不一定对每个账户都可用。以
/v1/models为准。
能用 OpenAI SDK 调用 Claude，或用 Anthropic SDK 调用 GPT 吗？
可以。网关在协议之间转换请求和响应。选择你的工具最擅长的协议即可。部分协议特有的功能可能无法转换，例如 Chat Completions 不能返回图片。
为什么看不到模型的思考过程？
- GPT 系列需要请求推理摘要：
"reasoning": { "summary": "auto" }。 - Claude 默认不思考。设置
reasoning_effort或thinking。 - 流式 Chat Completions 中，推理默认在
delta.reasoning_details[]中。只读取delta.reasoning_content的客户端可能显示不出推理。
详见思维链（推理）。
长任务超时怎么办？
- 使用流式输出。网关在等待上游时每 15 秒发送心跳，代理不会因为空闲断开连接。
- 提高客户端的超时设置。例如，Claude Code 可以设置
API_TIMEOUT_MS。 - 请使用
https://api.lynshen.org。https://www.lynshen.org经过网站 CDN，CDN 可能有自己的超时。
一个密钥可以在多个工具中使用吗？
可以。但建议每个工具使用单独的密钥。这样你可以在日志中按密钥区分用量，为每个工具设置消费限额，并在泄露时只禁用一个密钥。
LynShen Desktop 提示 device_ip_limit_reached
LynShen Desktop 的设备密钥最多在 5 个 IP 地址上使用。一个 IP 在最后一次请求后的 15 天内占用名额。在授权设备页面查看占用情况，或购买额外坐席。普通 API 密钥没有这个限制。
网关会保存我的请求内容吗？
请求日志记录模型、Token 数、费用和状态等元数据。网关默认不保存请求和响应的正文。只有开启了密钥的请求捕获选项时，网关才保存正文。
支持 Gemini CLI 或 Gemini 原生 API 吗？
不支持。网关没有 Gemini 原生端点。Gemini 模型请通过 Chat Completions、Responses 或 Messages 调用。
如何查询余额？
- 在控制台的钱包页面查看。
- 用 API 密钥请求
GET https://api.lynshen.org/user/balance。见其他端点。