51 lines
1.9 KiB
Plaintext
51 lines
1.9 KiB
Plaintext
---
|
||
title: Cursor 接入
|
||
sidebarTitle: Cursor
|
||
description: 在 Cursor 中配置海宇数科 API 与国内模型
|
||
---
|
||
|
||
# Cursor 接入
|
||
|
||
[Cursor](https://cursor.com) 支持使用 **OpenAI 兼容** 自定义接口。将 Base URL 指向海宇数科网关后，可在 Cursor 中选择控制台已上线的 **国内模型 ID** 进行补全与对话。
|
||
|
||
## 前置条件
|
||
|
||
1. 登录 [控制台](https://console.haiyushuke.com)，完成 **实名认证**
|
||
2. 在 **API Key** 创建密钥，并确认 Key 的 **可用模型** 包含你要用的模型 ID
|
||
3. 在 **模型广场** 复制目标模型 ID（例如 `deepseek-chat`、`glm-5.1` 等，以实际列表为准）
|
||
|
||
## 配置步骤
|
||
|
||
1. 打开 Cursor → **Settings**（设置）
|
||
2. 进入 **Models** 或 **OpenAI API** 相关区域（版本不同菜单名可能略有差异）
|
||
3. 填写：
|
||
- **OpenAI API Key**：海宇控制台创建的 API Key
|
||
- **Override OpenAI Base URL**（或 Custom OpenAI Endpoint）：`https://api.haiyushuke.com/v1`
|
||
4. 在模型列表中添加 **自定义模型名**，名称必须与模型广场 **模型 ID 完全一致**
|
||
5. 保存后在新对话中选择该模型进行测试
|
||
|
||
## 示例（settings.json 片段）
|
||
|
||
若你通过 `settings.json` 管理配置，可参考（键名以 Cursor 当前版本为准）：
|
||
|
||
```json
|
||
{
|
||
"openai.apiKey": "YOUR_HAIYUSHUKE_API_KEY",
|
||
"openai.baseUrl": "https://api.haiyushuke.com/v1"
|
||
}
|
||
```
|
||
|
||
自定义模型请在 Cursor 的 Models 界面添加，ID 使用控制台复制的字符串。
|
||
|
||
## 使用建议
|
||
|
||
- **不要** 使用 `gpt-4o`、`claude-sonnet` 等海外模型名；平台未提供这些模型。
|
||
- 生产环境 Key 不要提交到 Git；可配合 Key 的 **IP 白名单**。
|
||
- 若补全无响应，先在 **体验中心** 用同一模型 ID 验证，再查 [常见问题](/docs/faq)。
|
||
|
||
## 相关文档
|
||
|
||
- [工具接入概览](/docs/integrations/overview)
|
||
- [API Key 管理](/docs/guides/api_keys)
|
||
- [计费与财务](/docs/guides/billing)
|