算力猫
← 返回教程列表

接入软件

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 都对。

去创建 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)。