# Cursor 接入指南

https://omnimodel.me/apps/cursor?lang=zh

> AI 代码编辑器，可把对话侧的模型换成自定义端点。

## 适用场景

适合在编辑器里用对话方式写代码、解释和重构：把对话侧使用的模型指向平台的端点。Tab 补全仍使用 Cursor 自带的模型。

## 使用建议

编程场景的输入通常较长，建议选上下文较长的模型，并给密钥设置每日消费上限，避免长任务意外消耗过多。

## 连不通时检查

1. API 地址填 `https://omnimodel.me/v1`，不要多写 `/chat/completions`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 打开「Settings → Models」，展开 OpenAI API Key。
2. 填入密钥，勾选 Override OpenAI Base URL 并填入 API 地址。
3. 在模型列表中添加模型 ID，点 Verify 验证。

## 配置参数

- API 地址：`https://omnimodel.me/v1`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

> Tab 补全等内置能力只走 Cursor 自己的模型，覆盖 base URL 不会改变它们的计费。

## 常见问题

### Tab 补全会走平台的模型吗？

不会。自定义端点只对对话侧的模型生效，Tab 补全仍然使用 Cursor 自带的模型。

### 为什么提示模型不可用？

确认填写的模型 ID 与模型目录一致，并且在密钥的可用模型里。