LobeChat / NextChat 如何配置 Link-AI API？自定义接口配置教程
https://api1.link-ai.cc/v1，长请求（Claude Opus、复杂对话）建议使用 https://api2.link-ai.cc/v1。遇到 401/403/404/524 错误，先检查 API Key 和 Base URL 配置。
Base URL
普通请求：https://api1.link-ai.cc/v1
长请求（推荐）：https://api2.link-ai.cc/v1
API Key
sk-xxxxxxxx（从控制台获取）
前置准备
- 已安装 LobeChat 或 NextChat
- 拥有 Link-AI 账户，可在 api1.link-ai.cc 注册或登录
- 已获取 API Key（控制台 → API Keys → 创建密钥）
LobeChat 配置步骤
第一步：打开设置
点击左下角设置图标，进入「语言模型」设置页面。
第二步：添加供应商
找到「添加供应商」或「自定义接口」选项，选择 OpenAI-compatible 类型。
第三步：填入配置
名称：LinkAI 类型：OpenAI Base URL：https://api2.link-ai.cc/v1 API Key：sk-你的key
第四步：选择模型并测试
选择要使用的模型（如 gpt-5.5、Claude Opus），发送测试消息确认正常响应。
还没有 Key？ 在 Link-AI 控制台创建 API Key →
NextChat 配置步骤
第一步：打开设置
点击右上角设置图标，进入「模型设置」页面。
第二步：添加自定义模型
找到「自定义接口」选项，填入 Link-AI 配置信息。
第三步：填入配置
Base URL：https://api2.link-ai.cc/v1 API Key：sk-你的key
什么时候用 api1，什么时候用 api2？
| 通道 | Base URL | 适用场景 | 超时 |
|---|---|---|---|
| api1（Cloudflare 代理） | https://api1.link-ai.cc/v1 | 普通请求、网页端 | 120s |
| api2（直连，推荐长请求） | https://api2.link-ai.cc/v1 | Claude Opus，长上下文，长输出 | 源站控制 |
常见错误排查
| 错误 | 原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | API Key 无效或过期 | 检查 Key 格式，在控制台重新生成 |
| 403 Forbidden | Key 无目标模型权限 | 检查令牌绑定的渠道和模型 |
| 404 Not Found | Base URL 路径错误或模型名不支持 | 确认 Base URL 和模型名正确 |
| 524 Origin Timeout | Cloudflare 120 秒超时 | 切换到 api2.link-ai.cc/v1 |
| 503 Service Unavailable | 上游渠道不可用 | 稍后重试，或切换模型 |
和 Link-AI 有什么关系？
Link-AI 是什么？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型的接入服务。
- api1：普通 API 请求、网页端、登录、注册、充值
- api2：Claude Opus、Claude Code、Codex，长上下文，长输出、Agent 长任务直连通道
在 api1.link-ai.cc 控制台创建 API Key 后，即可在 LobeChat / NextChat 中使用。
如果担心扣费问题，使用 API 扣费检测工具验证 raw quota 变化。
常见问题
打开 LobeChat 设置 → 语言模型 → 添加供应商 → 选择 OpenAI-compatible → 填入 Base URL 和 API Key。
普通请求填 https://api1.link-ai.cc/v1；长请求（Claude Opus、复杂任务）填 https://api2.link-ai.cc/v1。
401 表示 Key 无效或过期；403 表示 Key 无目标模型权限。请检查 Key 和令牌权限。
524 表示 Cloudflare 超时。将 Base URL 从 api1 改为 api2.link-ai.cc/v1，直连源站不受 120 秒限制。
支持。Claude 模型通过 Link-AI 的 OpenAI-compatible 端点调用，使用 Claude Opus 等长请求推荐 api2 通道。
NextChat 支持自定义 OpenAI-compatible 接口。在设置中添加新的供应商，填入 Base URL 和 API Key 即可。
api1 适合普通请求、网页端；api2 适合 Claude Opus、长上下文、长输出和复杂任务。