IDE 模型选择器里的 Astra ≠ API 合同
Cursor 品牌专题：IDE 模型选择器里的 Astra ≠ API 合同。 锚点：Cursor。
가이드 목록 · 본문은 주로 중국어 간체입니다. 영문 요약(English summary)을 참고하세요.
## IDE 模型选择器里的 Astra ≠ API 合同
在 Cursor IDE 的模型选择器中，Astra 是一个可切换的具体模型选项，它直接指向 OpenAI 或 Azure OpenAI 等供应商的合同（协议）。你订阅 Cursor Plus 或 Business 时，平台默认处理合同细节，无需手动干预。想用特定模型却出现错误时，查看选择器里是否为 Astra，决定是否切换到其他选项或升级计划。
核心概念与术语
- Astra：OpenAI 或 Azure OpenAI 系列模型（如 GPT-6 Astra），Cursor 模型选择器中显示的部署名称。
- API 合同：供应商与 Cursor（或通过自定义 base URL 的网关）签订的模型供应协议。Cursor 官方合同提供内置模型与一定额度；自带 API key 时，实际由提供商直接结算。
- Token：模型调用计费单位，1 Token 通常代表 4 个字符（约 0.75 个单词）。
- $ /M：每百万 Token 的定价参考，通常指 OpenAI GPT 系列的约 0.60–15 $/M（视版本而定），Claude 系列约 3–15 $/M。
- Cursor Pro / Business：订阅层级，影响内置额度与支持模型范围。
- OpenAI：模型提供商，Astra 模型的主合同方。
- Grok / Claude Code：Cursor 支持的其他模型类别，与 OpenAI 合同无关。
这些概念在 Cursor 设置 > Models 页面直接体现。
决策表
| 场景 | 适合人群 | 推荐决策 | 理由 |
|---|---|---|---|
| 日常编码 + 预算控制 | 个人开发者，单项目需求 | 选 Cursor Pro + 其他非-Astra 模型 | Astra 成本高，无需重复合同 |
| 团队协作 + 多模型实验 | 团队，需灵活切换 | 选 Business 计划 | 统一合同，共享额度 |
| 已有自带 API key（OpenAI/Azure） | 已有 OpenAI 账户，费用敏感 | 切换到非-Astra 模型或卡网官方 | Astra 合同不匹配，自带 key 更灵活 |
| 卡网或限额使用 | 中国用户，需规避高费用 | 优先 Windsurf / Claude Code 等本地合同 | Astra 为 OpenAI 合同，官方路径更稳 |
| 想用非 OpenAI 模型 | 纯 Cursor 用户，实验需求 | 直接选内置模型 | Astra 仅限 OpenAI 合同 |
实操清单：分步可核对
1. 打开 Cursor，点击右上角模型选择器（或按 Cmd + /）。
2. 在列表中找到 Astra 选项，点击切换。
3. 如果出现“Unknown parameter”或请求失败，记录错误提示。
4. 检查订阅页面（cursor.com/official-prices），确认当前计划支持的模型。
5. 尝试切换到 Claude Sonnet 或 Grok 等内置模型，验证是否正常运行。
6. 若仍不稳定，前往 /official-api 或 /channels 查看当天定价与可用合同。
7. 核对 Token 使用情况，切换模型后重新计算单次调用成本。
常见坑与风险边界
- 合同误配：Astra 选择器选错提供商时，Cursor 会报“Unknown parameter”，模型直接无法调用。
- 额度隐藏：Cursor Pro/Business 内置额度有限，自带 API key 时使用需额外付费。
- 边界：OpenAI 与 Cursor 合同可能在特定日期终止（例如 2026 年 11 月前后），届时 Astra 不可用。
- 卡网限制：国内访问官方合同时，部分模型需翻墙或切换本地支持路径。
风险与边界
以上内容仅供参考，不构成法律意见。实际订阅或合同以官方页面为准，建议咨询 Cursor 客服确认最新合同条款与定价。
站内路径：相关工具与页面
- 查看所有 AI 编程工具对比：/channels
- 切换平台到 Cursor 页面：/channels?platform=cursor
- 官方价格与订阅详情：/official-prices
- 官方 API 合同入口：/official-api
- Cursor 工具栈与比较：/stack
- 订阅与定价一键对比：/compare
- 模板与示例：/templates
- 下载 Cursor：/downloads
- 最新订阅情报：/feed
- 完整使用指南系列：/guides
- 批发与企业合同：/wholesale
- 自定义 API 网关检测：/api-transit/detector
English summary
In the Cursor IDE model selector, Astra is a specific model name that points to an OpenAI or Azure OpenAI contract. This is different from your Cursor subscription contract, which governs your plan eligibility and built-in usage. When you switch to Astra in the selector, Cursor routes requests through your actual provider contract. To decide if you need it, check the selector first and compare with the pricing page for your current plan. For most users, staying with Cursor's native models avoids contract confusion and extra costs. If you have your own API key, switch models instead of relying on Astra to stay within budget. Always verify availability on the official pricing page, as contracts can change. This setup lets you experiment safely without mismatched agreements.