跳到主要内容

Cursor 集成 TopRouter API 密钥

概述​

Cursor 支持集成第三方 API 密钥，让您可以使用自己的 API 账户调用各种大型语言模型（LLM）提供商的服务。通过配置 TopRouter API 密钥，您可以：

  • 成本控制：使用自己的 API 账户，按实际使用量付费
  • 无限制使用：不受 Cursor 官方使用配额限制
  • 模型选择：访问 TopRouter 平台支持的多种先进模型

功能限制说明​

注意事项

Cursor 普通用户暂不支持自定义 API 密钥。

自定义 API 密钥仅适用于聊天对话和代码生成等核心功能。

配置步骤​

步骤一：获取 TopRouter API 密钥​

  1. 访问 TopRouter 平台
  2. 登录您的账户并导航至 API 密钥管理页面
  3. 创建新的 API 密钥并复制保存

步骤二：在 Cursor 中配置 API 密钥​

  1. 打开 Cursor 设置：Cursor 设置 → 模型
  2. 在 API 密钥配置区域：
  3. 点击 "开启" 按钮确认密钥有效性

API 密钥配置界面

步骤三：添加支持的模型​

配置完成 API 密钥后，您需要添加要使用的模型：

  1. 在模型配置区域点击 "添加模型" Cursor 模型配置
  2. 参考 TopRouter 模型列表 选择合适的模型 模型列表参考
  3. 输入模型名称（需与 TopRouter 平台的模型标识符完全一致） 模型详细信息
模型选择建议
  • 代码生成：推荐使用 Claude 4 Sonnet 系列
  • 日常对话：可选择性价比更高的模型如 Claude Haiku 系列
  • 特殊任务：根据具体需求选择专门优化的模型

常见问题解答​

API 密钥的安全性如何保障？​

您的 API 密钥不会被 Cursor 永久存储，但在每次 API 调用时会通过 Cursor 的服务进行转发。Cursor 负责最终的提示词构建和请求处理。

安全提醒
  • 请妥善保管您的 API 密钥，避免泄露
  • 建议定期轮换 API 密钥以提高安全性
  • 可在 TopRouter 平台设置使用限额和监控

支持哪些 API 提供商？​

Cursor 支持所有与 OpenAI API 格式兼容的服务提供商，包括但不限于：

  • TopRouter：聚合多种先进模型的统一 API 平台
  • OpenAI：GPT 系列模型的官方提供商
  • Anthropic：Claude 系列模型提供商
  • Google：Gemini 系列模型提供商
  • 其他兼容 OpenAI API 格式的服务商

如何排查配置问题？​

密钥验证失败：

  1. 确认 API 密钥复制完整，无多余空格
  2. 检查 TopRouter 账户余额是否充足
  3. 验证 Base URL 设置是否正确

模型调用失败：

  1. 确认模型名称与 TopRouter 平台完全一致
  2. 检查该模型是否在您的 TopRouter 账户中可用
  3. 查看 TopRouter 平台的使用限制和配额

性能问题：

  • 选择地理位置较近的 API 端点以降低延迟，如北美
  • 根据任务类型选择合适的模型以平衡性能和成本

相关资源​