Api Halo 文档中心

Cursor 接入 Api Halo 教程

在 Cursor 中使用自定义 OpenAI 兼容 API,配置 Api Halo 地址、令牌与可用模型。

发布与更新:2026-07-12 · 中文技术教程

下载 Cursor

从 Cursor 官方网站下载 Windows、macOS 或 Linux 版本。

Cursor 官方下载 →

准备信息

Base URL:https://apihalo.cn/v1
API Key:Api Halo 独立令牌
模型:从模型广场复制准确名称

配置步骤

  1. 打开 Cursor 设置中的 Models 或模型提供商区域。
  2. 找到 OpenAI API Key 或支持自定义 OpenAI Base URL 的选项。
  3. 填入 Api Halo 令牌和接口地址。
  4. 添加当前可用模型并保存。
  5. 新建对话进行最小测试。
Cursor 的界面和自定义 API 支持可能随版本与功能策略变化。如果当前版本不提供对应入口,应以 Cursor 官方说明为准,不要安装非官方补丁。

验证是否成功

确认 Cursor 获得模型回复,并检查 Api Halo 控制台日志中的状态码、模型名和耗时。

常见问题

为什么找不到 Base URL?

先更新到官方当前版本并检查模型设置;部分功能可能因版本或账户方案不同而变化。

为什么返回 403?

通常是令牌分组没有目标模型权限,或模型名不一致。

配套在线工具

按本教程确认安装方式后,带入对应软件生成配置,再执行一次最小连接测试。