ChatBox / Cherry Studio / NextChat / LobeChat

这一类通用对话 GUI 的配置逻辑完全一样：选 OpenAI 兼容协议 → 填 Base URL → 填令牌 → 手动加模型。

统一要填的值：

字段	值
API 地址 / Base URL / Endpoint	https://api.52pay.com/v1
API Key	<您的令牌>
模型	站内任意模型 ID，如 claude-sonnet-4-6

部分客户端会自动补 /v1

Cherry Studio、NextChat 等在你只填域名时会自动补 /v1。如果填了 https://api.52pay.com/v1 反而变成 /v1/v1 → 404。

判断方法：先填带 /v1 的完整地址试一次；报 404 就去掉 /v1 再试。两次之内一定能通。

---

ChatBox

1. 打开 ChatBox → 设置
2. 模型提供方 选 OpenAI API 或 添加自定义提供方
3. 填写：
   • API 域名 / API Host：https://api.52pay.com
   • API 路径：/v1/chat/completions（若有此字段）
   • API 密钥：<您的令牌>
4. 模型 里点「+ 新增」，手动填模型 ID
5. 保存 → 新建对话测试

ChatBox 会调用 /v1/dashboard/billing/subscription 显示余额，能显示出来就说明令牌完全正常。

---

Cherry Studio

1. 打开 Cherry Studio → 左下角 设置 → 模型服务
2. 点 + 添加，类型选 OpenAI
3. 填写：
   • API 密钥：<您的令牌>
   • API 地址：https://api.52pay.com（Cherry Studio 会自动补 /v1）
4. 点「管理」→ 添加模型，或点「检查」自动拉取模型列表
5. 回到对话页，右上角选中刚才添加的模型

Cherry Studio 的知识库

Cherry Studio 的知识库功能需要 embedding 模型。本站的 embedding 走同一个 /v1/embeddings 接口，在模型列表里添加对应的 embedding 模型 ID 即可。

---

NextChat

1. 打开 NextChat → 设置
2. 接口地址：https://api.52pay.com
3. API Key：<您的令牌>
4. 自定义模型名填入（用英文逗号分隔，-all 表示先清掉默认列表）：

-all,claude-opus-4-8,claude-sonnet-4-6,claude-haiku-4-5-20251001,gpt-5.5,gpt-5.4,gpt-5.4-mini,gemini-3-pro-preview,gemini-3.5-flash,deepseek-v4-pro,glm-5.2,kimi-k3

5. 回到对话页选择模型

---

LobeChat

1. 打开 LobeChat → 设置 → 语言模型
2. 找到 OpenAI，打开开关
3. 填写：
   • API Key：<您的令牌>
   • 接口代理地址：https://api.52pay.com/v1
4. 模型列表里点「获取模型列表」或手动添加
5. 保存

自部署 LobeChat 时也可以直接用环境变量：

OPENAI_API_KEY=<您的令牌>
OPENAI_PROXY_URL=https://api.52pay.com/v1

---

推荐模型（聊天场景）

场景	模型
日常问答	claude-sonnet-4-6、gpt-5.4、glm-5.2
长文档处理	gemini-3-pro-preview（1M 上下文）、gpt-5.5
深度推理	claude-opus-4-8、gemini-3.1-pro-preview
便宜跑量	gemini-3.1-flash-lite、gpt-5.4-mini、deepseek-v4-flash
画图	gemini-3-pro-image、gpt-image-2、qwen-image-2.0-pro

常见错误

现象	原因 / 处理
返回 404	/v1 加了两次，或一次都没加，见上面提示
返回一坨 HTML	Base URL 打到了网页路由，加上 /v1
「获取模型列表」为空	令牌无效，或该分组没开放模型
能聊天但图片发不了	选的模型不支持视觉，换带 Vision 标签的模型
余额显示异常	客户端按 OpenAI 官方口径换算，以控制台为准

配套阅读

• 模型与分组
• 原生 API 调用