主题
客户端兼容性总览
本站基于 OpenAI v1 协议,理论上所有声称兼容 OpenAI API 的客户端都能直接接入。配三个字段就够了:
| 字段 | 值 |
|---|---|
| Base URL / API Endpoint | https://s1.why01.top 或 https://s1.why01.top/v1(按客户端要求) |
| API Key | 控制台「令牌管理」创建的 sk-xxxxxxxx |
| Model | 按 控制台模型页 实际可用名填 |
已验证可用的客户端
本表只列用户实际反馈过用得通的客户端。未列出不代表不能用——按 OpenAI 兼容方式接入大概率都行,欢迎用了之后给客服反馈,会陆续补到这里。
| 客户端 | 类型 | 接入说明 | 需要的 Base URL 末尾 |
|---|---|---|---|
| Cherry Studio | 桌面对话客户端 | 添加自定义 OpenAI provider | /v1 |
| OpenWebUI | Web 部署版 ChatGPT 类 | 配置 OpenAI API 字段 | /v1 |
| Cursor | AI IDE | 设置自定义 OpenAI 端点 | 不带 /v1 |
| Claude Code | Anthropic 官方 CLI | 通过 ANTHROPIC_BASE_URL 环境变量 | 根域 |
其他客户端(社区报告可用)
| 客户端 | 接入提示 |
|---|---|
| ChatBox | OpenAI API 配置框直接填 |
| LobeChat | 自定义 OpenAI provider |
| 沉浸式翻译 | 翻译服务选「自定义 OpenAI 兼容」 |
| BotGem / Bob | 翻译类 OpenAI 接入 |
| Continue (VSCode 插件) | provider 选 openai + 自定义 baseUrl |
| Dify / FastGPT (自部署) | LLM 提供商选 OpenAI-compatible |
如果你接入了一个本表没列的客户端
欢迎 联系客服 报告步骤,我们补到文档里方便后续用户。
三类常见接入坑
1. Base URL 是否含 /v1
各客户端要求不同:
- 有的要求
https://s1.why01.top/v1(自己拼端点) - 有的要求
https://s1.why01.top(自己加/v1前缀)
如果第一种填法不通,调换试一次就能定位。
2. 模型名拼错
客户端通常允许自由填模型名。务必和 控制台模型页 显示的完全一致(含大小写、版本日期后缀)。
3. 流式响应中断
部分客户端默认 SSE timeout 较短。长 prompt 触发上游 idle timeout 时表现为"没等到响应就断了"。客户端侧调大 HTTP timeout(推荐 ≥ 5 分钟)。
不兼容 / 不推荐的客户端
| 客户端 | 原因 |
|---|---|
| OpenAI 官方 ChatGPT App | 仅认 OpenAI 官方账号,不接受自定义 endpoint |
| Anthropic 官方 Claude.ai | 同上 |
| Google Gemini App | 同上 |
下一步
按你用的客户端直接看对应页:
- Cherry Studio
- OpenWebUI
- Cursor
- Claude Code(已迁到「AI 编程工具」分类)