Chat 客户端接入指南

本文覆盖桌面端和 Web 聊天客户端的常见接入方式。

这类客户端大多按 OpenAI Chat Completions 的 choices 结构读取返回。

所以第一条测试请求，统一建议先用 claude-sonnet-4-6。

通用准备

1. 生成 API Key：sk-xxxxx
2. 准备地址：https://anideaai.com/v1
3. 选择模型：先用 claude-sonnet-4-6

ChatBox

设置路径：设置 → 模型提供方 → 自定义/OpenAI

填写项：

• API Host：https://anideaai.com/v1
• API Key：sk-xxxxx
• Model：claude-sonnet-4-6

常见问题：

• 无法连接：确认没有误填成 http
• 历史会话报错：清理旧提供方缓存后重试

Cherry Studio

设置路径：设置 → 模型服务 → 新增服务商

填写项：

• 服务类型：OpenAI 兼容
• Base URL：https://anideaai.com/v1
• API Key：sk-xxxxx
• 默认模型：claude-sonnet-4-6

常见问题：

• 模型切换失败：关闭自动拉取模型列表，改手工输入

Lobe-Chat（自部署）

环境变量示例：

OPENAI_API_KEY=sk-xxxxx
OPENAI_API_BASE_URL=https://anideaai.com/v1
DEFAULT_MODEL=claude-sonnet-4-6

部署后在管理页面确认模型可用。

常见问题：

• 报跨域：优先通过服务端环境变量配置，不要只在前端写地址

ChatGPT-Next-Web（自部署）

环境变量示例：

OPENAI_API_KEY=sk-xxxxx
BASE_URL=https://anideaai.com/v1
CUSTOM_MODELS=claude-sonnet-4-6,claude-opus-4-6

常见问题：

• 对话页无模型：检查 CUSTOM_MODELS 是否填写

Open WebUI

设置路径：管理员面板 → Connections → OpenAI

填写项：

• API Base URL：https://anideaai.com/v1
• API Key：sk-xxxxx

常见问题：

• 请求超时：调大 Open WebUI 的请求超时上限

LibreChat（自部署）

在 librechat.yaml 或环境变量中配置 OpenAI 兼容端点：

endpoints:
  openAI:
    apiKey: "${ANIDEAAI_API_KEY}"
    baseURL: "https://anideaai.com/v1"
    models:
      default:
        - claude-sonnet-4-6

常见问题：

• 启动后不显示模型：重启容器并清理浏览器缓存

BotGem

设置路径（常见）：设置 → API 设置 → 自定义接口

填写项：

• Base URL：https://anideaai.com/v1
• API Key：sk-xxxxx
• Model：按账户可用模型填写

常见问题：

• 老版本不支持自定义地址：升级到新版本再配置

常见踩坑汇总

1. 客户端有“代理地址”和“API 地址”两个输入框，必须填在 API 地址。
2. 有些客户端默认自动补 /v1，如果你已经写了 /v1 可能变成重复路径。出现 404 时先检查最终请求路径。
3. 模型名区分大小写，建议从 /v1/models 复制。
4. 如果你换成 gpt-5.4 后界面报空响应或解析错误，先退回 claude-sonnet-4-6 做首测。