Cursor 自定义 API Provider 怎么选？Base URL、模型权限和 403 排查

🤖 AI 摘要

Cursor 是基于 VS Code 的 AI 编程工具，支持 OpenAI-compatible API Provider 配置。普通编程任务（代码补全、快速问答）用 api1.link-ai.cc 即可，需要长上下文和深度代码理解时建议用 api2.link-ai.cc。403 错误是 Cursor 配置中最常见的问题，通常是因为 API Key 没有对应模型的访问权限——Link-AI 控制台中的用户分组和渠道权限需要正确配置。

💡 直接答案

Cursor 配置 Link-AI：在 Settings → Models → Custom Model Sources 中添加 Provider。普通任务用 https://api1.link-ai.cc/v1，长代码任务用 https://api2.link-ai.cc/v1。遇到 403 时，先在 Link-AI 控制台检查你的 Key 是否有该模型的访问权限。详细配置参考 Cursor API 配置教程。

Cursor 适合用 api1 还是 api2

场景	推荐通道	原因
代码补全（Tab 键）	api1	速度快，请求时间短
快速问答	api1	响应快，不需要长连接
长代码生成	api2	长输出更稳定
代码重构	api2	需要长上下文理解
架构设计和评审	api2	长任务，高概率超时

403 的常见原因

403 Forbidden 是 Cursor 配置中最常见的错误，原因包括：

模型权限不足：Key 所属的用户分组只能访问 Sonnet，但请求了 Opus
渠道配置问题：Link-AI 后台没有为该模型配置可用渠道
Key 已过期或被禁用：Token 状态异常
请求格式问题：模型名拼写错误或不被支持

⚠️ 最常见原因

Link-AI 后台中，用户分组决定了能访问哪些渠道，渠道决定了支持哪些模型。如果你的 Key 只能访问 Sonnet 渠道，你请求 Opus 时就会返回 403。联系 Link-AI 客服确认你的用户分组和渠道权限。

模型权限和用户分组的关系

Link-AI 的权限体系：

用户分组 → 渠道权限 → 模型访问

用户分组：管理员在后台创建的分组（如"基础用户""高级用户"）
渠道权限：每个分组可以访问不同的渠道
模型访问：每个渠道支持的模型列表

所以：你的 API Key 能访问哪些模型，取决于你的账号属于哪个用户分组，以及该分组有哪些渠道权限。

Key 权限和模型名的关系

请求时用的模型名必须满足两个条件：

是你有权限访问的渠道所支持的模型
模型名拼写正确（与 Link-AI 后台配置一致）

例如：

如果你的渠道支持 claude-3-sonnet，你可以请求 claude-3-sonnet
如果你的渠道只支持 Sonnet，你请求 claude-3-opus 会返回 403
如果模型名拼写为 claude-3.5-sonnet（中间是点不是横线），也会报错

Cursor 配置步骤

打开 Cursor → Settings → Models
找到 "Custom Model Sources" 或 "Add custom provider"
填写 Provider 信息：
- Name: Link-AI
- Base URL: https://api1.link-ai.cc/v1 或 https://api2.link-ai.cc/v1
- API Key: 你的 Link-AI API Key
在 Models 中选择要使用的模型（如 claude-3-sonnet）

详细图文教程：Cursor API Base URL 配置

常见错误排查

错误	原因	解决方案
403	Key 没有该模型的访问权限	检查用户分组和渠道权限，参考 403 排查指南
401	API Key 无效或未设置	确认 API Key 正确，格式为 sk-xxx
404	模型名不存在或 Base URL 错误	确认 Base URL 以 /v1 结尾，模型名与后台配置一致
524	任务太长，Cloudflare 超时	切换到 api2 直连通道