Appearance
Cursor 接入指南
Cursor 是流行的 AI 代码编辑器。通过自定义 OpenAI 兼容 API,可接入 TopsDyne 的模型。
配置方法
1. 打开设置
进入 Cursor:Settings → Models(或 Cmd + Shift + J / Ctrl + Shift + J)。
2. 添加自定义 Provider
- 找到 OpenAI API Key 区域
- 填入你的 TopsDyne API Key:
sk-xxx - 点击 Override OpenAI Base URL,填入:
https://api.topsdyne.com/v1
3. 选择模型
在模型列表中输入在售模型 ID(在售模型与型号以控制台模型广场实时展示为准,示例占位:your-model-id),勾选启用。
协议说明
Cursor 使用 OpenAI 兼容协议:
- Base URL:
https://api.topsdyne.com/v1(必须带 /v1) - 鉴权:
Authorization: Bearer sk-xxx
模型配置
推荐模型:在售模型与型号以控制台模型广场实时展示为准。
验证
在 Cursor 对话框中输入 Cmd + L(或 Ctrl + L),发送一条消息,确认返回正常。
故障排查
| 现象 | 处理 |
|---|---|
| 401 | API Key 错误,或未填 Base URL |
| 403 model not allowed | 当前套餐不含该模型,换用在售模型或升级套餐 |
| 连接失败 | 检查 Base URL 是否带 /v1 后缀 |
下一步
- Cherry Studio 接入 — 桌面客户端
- 接入协议 — 协议细节
- 常见问题 — 更多问答