# LobeHub

LobeHub 可以添加自定义 AI 服务商。请求格式选 OpenAI、地址填到 /v1，就能使用 NezhaGate 的模型；自部署也可以用环境变量配置。

> https://nezhagate.com/docs/integrations/lobehub

按此版本编写：LobeHub 2.2

## 添加自定义服务商

1. 打开 **App Settings** → **AI Providers**，点 **Add Custom Provider**。

2. **Provider ID** 填一个小写 ID（只能用小写字母、数字、`-` 和 `_`，创建后不能改），**Request Format** 选 **OpenAI**，**Proxy URL** 填 `https://nezhagate.com/v1`，**API Key** 填你的 Key，点 **Create**。

3. 在服务商页面点 **Fetch models**，或用 **Add Model** 手动添加；手动添加时填上最大上下文，并按模型能力勾选工具调用、图片输入。

4. 启用要用的模型，回到对话里选中它。

Proxy URL`https://nezhagate.com/v1`

保持 **Use Client Request Mode** 关闭（NezhaGate 的接口不接受浏览器的跨域请求），**Use Responses API Specification** 也保持关闭。

## Claude（可选）

再添加一个自定义服务商，**Request Format** 选 **Anthropic**，**Proxy URL** 填 `https://nezhagate.com/anthropic`。

## 自部署：环境变量

自部署的 LobeHub 可以直接用环境变量配置 NezhaGate：

```
OPENAI_API_KEY=YOUR_API_KEY
OPENAI_PROXY_URL=https://nezhagate.com/v1
OPENAI_MODEL_LIST=-all,+gpt-5.5,+claude-sonnet-5
ANTHROPIC_API_KEY=YOUR_API_KEY
ANTHROPIC_PROXY_URL=https://nezhagate.com/anthropic
```

`OPENAI_MODEL_LIST` 里，`-all` 隐藏所有自带的模型，`+model-id`（换成模型 ID）加入 NezhaGate 的模型，`+model-id=Display name` 同时设置显示名。

## 测试

在服务商页面的 **Connectivity Check** 里选一个模型，点 **Check**（会发一条很短的消息），显示 Check passed 即可。

## 常见问题

**没有回复，或回复为空**

Proxy URL 要带 `/v1`，也就是 `https://nezhagate.com/v1`。

**Failed to fetch models**

检查 Key 和 Proxy URL；也可以用 **Add Model** 手动添加模型。

**浏览器控制台报跨域（CORS）错误**

关掉 **Use Client Request Mode**，让请求从 LobeHub 的服务端发出。