很多人用 Cursor、Claude Code、Dify、OpenWebUI 时，第一步就卡在模型接口：官方 Key 不好申请，不同平台 Key 分散，模型名、base_url、余额日志也不统一。

我的做法是用一个 OpenAI 兼容的聚合 API，把 Claude、GPT、Gemini、DeepSeek 等模型统一接到常用工具里。本文以 hoapi 为例，讲清楚 Cursor 怎么配置。

注册链接：
https://hoapi.top/sign-up?aff=UqqS

## 一、你只需要理解三个字段

大多数 AI 工具接第三方模型，本质上都绕不开这三个字段：

```text
base_url = API 接口地址
api_key = 控制台创建的令牌
model = 要调用的模型名称
```

只要工具支持 OpenAI Compatible / Custom API / 自定义接口，一般就可以按这个思路接入。

## 二、注册并创建 API Key

1. 打开注册链接：https://hoapi.top/sign-up?aff=UqqS
2. 注册并进入控制台
3. 找到“令牌 / API Key”入口
4. 创建一个测试 Key
5. 找到平台文档里的 base_url 和模型名称

建议第一次只小额测试，不要直接大额充值。先确认模型、速度、日志、扣费都正常。

## 三、Cursor 配置步骤

1. 打开 Cursor 设置
2. 找到 Models / API / Custom Provider 相关配置
3. 选择 OpenAI Compatible 或自定义接口
4. 填入 base_url
5. 填入 API Key
6. 填入模型名称
7. 保存后发一条测试消息

测试提示词可以用：

```text
请用 Python 写一个函数，输入一段文本，返回出现次数最多的 5 个词。
```

如果能正常返回代码，说明接口基本通了。

## 四、常见报错

| 报错 | 常见原因 | 解决方式 |
|---|---|---|
| 401 Unauthorized | Key 错误或失效 | 重新复制 API Key |
| 404 Not Found | base_url 填错 | 检查是否需要 `/v1` |
| model not found | 模型名错误 | 到模型列表复制准确名称 |
| insufficient quota | 余额不足 | 检查额度 |
| timeout | 模型慢或网络波动 | 换模型或重试 |

排查顺序建议：先用 Chatbox 测 API 是否能通，再接 Cursor / Dify。不要一开始就在复杂工具里排查所有问题。

## 五、适合哪些场景

- Cursor AI 编程
- Claude Code 辅助开发
- OpenWebUI 本地聊天
- Chatbox 日常测试
- Dify 工作流
- Python / Node.js 自动化脚本

## 六、Python 调用示例

```python
from openai import OpenAI

client = OpenAI(
    api_key="你的 API Key",
    base_url="你的 base_url"
)

resp = client.chat.completions.create(
    model="你的模型名称",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}]
)

print(resp.choices[0].message.content)
```

## 七、最后建议

个人学习、AI 编程、原型验证，用这种聚合接口会省很多事。但如果是企业生产环境，特别涉及敏感数据、合规、SLA，建议更谨慎，优先走官方或企业级供应商。

注册链接：https://hoapi.top/sign-up?aff=UqqS