跳转到主要内容
Cursor 的自定义 API 设置用于客户端允许使用外部模型的功能。可用入口与套餐要求随版本变化，先确认你的客户端允许填写自定义地址和模型。

配置步骤

  1. 打开 Settings → Models。
  2. 在 OpenAI API Key 区域启用自定义密钥，填写 APIONE API Key。
  3. 启用 Override OpenAI Base URL，填写 https://api.apione.ai/v1。
  4. 使用 Add Custom Model 添加 APIONE 当前可用的模型 ID，并启用该模型。
  5. 在聊天面板主动选择这个模型，发起一轮新对话。
Cursor Models 页面展示 APIONE Base URL 与掩码 Key

Cursor 的 Models 配置示例。启用 OpenAI API Key 和 Override OpenAI Base URL。

检查实际调用

先发送简单文本，再尝试代码解释与工具调用。可在 APIONE 控制台核对请求；仅通过设置页的 Verify 不代表每种聊天模式都兼容。自定义密钥也不意味着 Tab 补全或所有专属能力都会改由 APIONE 提供。

遇到错误时

  • 提示升级套餐：查看 Cursor 当前账户策略。
  • 模型不存在：从 APIONE 模型目录重新复制 ID。
  • messages、input 或工具定义报错：核对请求使用 Chat Completions 还是 Responses，再确认模型支持对应格式。
  • URL 错误：检查最终路径是否重复附加 /v1。
不要把其他网关的兼容性问题或修复结论直接套到 APIONE；提交反馈时附客户端版本、模型 ID、请求 ID 和脱敏错误。
返回集成目录 · 模型选择 · 错误排查