> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor 接入 APIONE

> 设置自定义 OpenAI 地址并验证聊天模型。

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](https://mintcdn.com/apione/RowHqDetrhht-bZO/images/integrations/screenshots/cursor-apione-api-settings-v2.png?fit=max\&auto=format\&n=RowHqDetrhht-bZO\&q=85\&s=5a921e0766e1e66f205233bfd8b56011)

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

## 检查实际调用

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

## 遇到错误时

* 提示升级套餐：查看 Cursor 当前账户策略。
* 模型不存在：从 [APIONE 模型目录](https://apione.ai/zh/models)重新复制 ID。
* `messages`、`input` 或工具定义报错：核对请求使用 Chat Completions 还是 Responses，再确认模型支持对应格式。
* URL 错误：检查最终路径是否重复附加 `/v1`。

不要把其他网关的兼容性问题或修复结论直接套到 APIONE；提交反馈时附客户端版本、模型 ID、请求 ID 和脱敏错误。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.