客户端接入总览
不想写代码？大多数主流 AI 客户端都支持「自定义 OpenAI 接口地址」。只要把两样东西填进去，就能用本平台的全部模型：
- API 地址（Base URL）：
https://gateway.mindproxy.ai/v1 - API Key：你在控制台创建的
sk-...
通用规律
本平台对外是 OpenAI 兼容接口。任何「支持自定义 OpenAI API 地址」的客户端，填法都一样：地址填到 /v1，Key 填你的 sk-...，模型填平台支持的模型 ID。下面按客户端给出具体填法。
各客户端跳转
| 客户端 | 平台 | 适合 |
|---|---|---|
| Cherry Studio | Win / Mac / Linux 桌面 | 功能全、多模型、知识库 |
| ChatBox | 桌面 / 移动 / 网页 | 简单好上手 |
| NextChat | 网页 / 桌面 | 可自部署、轻量 |
| Cursor | 代码编辑器 | AI 编程 |
| Open WebUI | 自部署网页 | 团队共享、本地部署 |
关于「Base URL 要不要带 /v1」
不同客户端对地址的处理不一样，这是最常见的坑：
- 多数客户端的「API 地址 / API Host」要填到
https://gateway.mindproxy.ai/v1。 - 少数客户端会自动补
/v1，这种只填https://gateway.mindproxy.ai。 - 如果调用报
404或「路径找不到」，多半是/v1多了或少了，调整一下即可。
模型名怎么填
填平台支持的公开模型 ID，例如 gpt-4o-mini、claude-3-5-sonnet、gemini-1.5-pro。
- 完整列表见 模型与套餐，或在控制台「模型价格」页查看。
- 也可以用 API 列出：
GET /v1/models。
通用排障
| 现象 | 可能原因 |
|---|---|
| 401 未授权 | Key 填错 / 带了多余空格 / Key 被禁用 |
| 404 找不到 | Base URL 的 /v1 多了或少了 |
| 模型不可用 / 403 | 模型不在该 Key 的 scope 内，或模型 ID 拼错 |
| 402 | 余额不足或超出 Key 月额度，去 充值 |
| 429 | 触发限流，稍后重试 |
更多见 错误码与限流。