接入 Cursor

Cursor 走的是 OpenAI 兼容协议,所以接入 AIUV 只用改两个字段。

设置位置

打开 Cursor → Cmd + ,(Windows: Ctrl + ,)→ Models 这一栏。

必填三项

OpenAI Base URL:   https://aiuv.ai/v1
OpenAI API Key:    sk-YOUR_KEY
Model:             gpt-5    （或 claude-opus-4-7、gemini-2.5-pro 等)

填完点 Verify 按钮 —— 出现绿色对勾说明通了。

推荐选哪个模型

Cursor 的代码用法主要是两类:Chat 和 Tab(行内补全)。

• Chat 用 Claude / GPT 4 / 5 大型号:可读性、调试问答、解释代码强
• Tab 用 Sonnet / GPT 5 mini / GPT-OSS / Codex 类:速度优先,字数少

控制台 → 模型 页可以看哪些是热门 / 价格表对比。

自定义模型列表

Cursor 默认只显示有限几个 OpenAI 模型。要让它列出 AIUV 上的全部模型:

1. 进 Cursor 的 Models 设置
2. 找到 Add Model 或 "Other Models" 区块
3. 把模型 ID(就是 /api/pricing 返回的 model_name)逐个加进去
4. 保存,Cursor 的模型下拉里就会出现

Cursor 不会主动从 base URL 探测可用模型 —— 你得手动告诉它有哪些。

故障排查

• 401 Unauthorized:key 错了或被禁用。控制台 → API Keys 检查状态,必要时重置
• 模型 not found:Cursor 的模型字段填的是它自己的别名,而不是 AIUV 的 model_name。改成 AIUV 控制台里能查到的那个名字
• 响应空白:大概率是 Cursor 期望的字段(tools / tool_choice 等)上游不支持。换一个支持工具调用的模型再试

想看完整 Raw 请求

控制台 → 对话日志(需要在管理设置里开启)能看到 Cursor 真实发了什么、上游回了什么。