接入软件
Jan
开源桌面客户端:添加一个自定义提供方。
约 4 分钟适合:用 Jan 聊天的用户
开始之前
- 已安装 Jan
- 一把 Key 和一个模型名
步骤 1 · STEP 0x01
添加自定义提供方
Settings → Model Providers
1
Add Provider
2
API format
OpenAI-compatible
3
Provider name
随便取
进入 Settings → Model Providers,点 Add Provider。在 Add Custom Provider 对话框里 API format 选 OpenAI-compatible(要用 Claude 系列可选 Anthropic-compatible)。官方提醒:格式选错会导致请求失败,哪怕地址和 Key 都对。
步骤 2 · STEP 0x02
填 Base URL 和 Key
Add Custom Provider
1
Base URL
https://api.suanlimao.shop/v1
2
API key
<你的 Key>
3
Create
- 官方加粗强调:Base URL 必须包含服务端期望的版本路径,所以填带 /v1 的
https://api.suanlimao.shop/v1。选 Anthropic-compatible 时填不带 /v1 的https://api.suanlimao.shop。 - 点 Create 保存。
步骤 3 · STEP 0x03
确认模型列表并聊天
你的提供方 → Models
1
+(手动添加模型 ID)
2
Model ID
<模型名>
3
聊天里的模型选择
<模型名>
- 保存时 Jan 会从地址的 /models 拉取模型列表;我们的接口支持,所以通常会自动出现。没有的话在 Models 里点 + 手填模型 ID。
- 在聊天里选这个模型,发一句话。
模型名不要自己猜:到「模型广场」点模型卡片上的「复制模型名」,再粘贴到软件里。模型名写错是最常见的报错原因。
✓ 怎么确认成功了
- 聊天有回答;控制台「用量」页出现请求。
常见问题
每个请求都 404?
官方排错表:Base URL 少了 /v1 或路径不对。
401 / 403?
Key 错误或缺失。
请求立刻失败?
API format 选错了(OpenAI-compatible 与 Anthropic-compatible 弄反)。
429?
触发限速,稍等再试;长期如此可以在 Key 设置里看限速并提工单。
相关教程
还是不行?
先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。