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

# Cursor 集成

> 在 Cursor 中配置 APIAny.AI API Key、Base URL 和推荐模型。

[Cursor](https://cursor.com/) 可以通过 OpenAI 兼容配置接入 APIAny.AI。完成配置后，你可以在同一个客户端中使用对话、推理、翻译和多模态模型。

## 准备工作

* 已安装 Cursor。
* 已在 [APIAny.AI 控制台](https://apiany.ai/zh/dashboard/api-keys) 创建 API Key。
* 已准备一个要使用的模型 ID，例如 `gpt-5.4-mini` 或 `gpt-4o-mini`。

## 配置值

| 字段                       | 填写内容                      |
| ------------------------ | ------------------------- |
| OpenAI API Key           | 你的 APIAny.AI API Key      |
| Override OpenAI Base URL | `https://apiany.ai/v1`    |
| 模型                       | `gpt-5.4-mini`, `gpt-5.5` |

## 配置步骤

1. 打开 Cursor 设置中的 Models 区域。
2. 开启 OpenAI API Key 配置。
3. 填写 API Key，并将 OpenAI Base URL 覆盖为 APIAny.AI 地址。
4. 添加需要使用的模型 ID，在 Chat 或 Composer 中测试。

## 推荐模型

| 模型 ID               | 适用场景                        |
| ------------------- | --------------------------- |
| `gpt-5.5`           | 适合复杂推理、编码和生产级工作流，优先推荐。      |
| `gpt-5.4`           | 适合高级对话、Agent 和通用生产任务。       |
| `gpt-5.4-mini`      | 速度、质量和成本均衡，适合日常高频使用。        |
| `gpt-4o-mini`       | 适合简单对话、翻译和轻量任务，速度快、成本低。     |
| `claude-sonnet-4-6` | 适合 Claude 兼容配置的长文本、写作和编码任务。 |
| `gemini-3.5-flash`  | 适合 Gemini 兼容配置的快速多模态任务。     |

## 操作截图

以下截图展示 Cursor 中的关键配置入口和保存后的使用界面。截图中的 API 地址和名称均已按 APIAny.AI 调整。

### 步骤 1

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/main-interface.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=917805a45622af61e0e5cd680d3656f1" alt="Cursor 配置截图 1" width="1200" height="800" data-path="images/integrations/cursor/main-interface.png" />

### 步骤 2

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/settings-models.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=4ee3fec725f911675dced3b8247c1421" alt="Cursor 配置截图 2" width="1200" height="800" data-path="images/integrations/cursor/settings-models.png" />

### 步骤 3

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/api-config.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=92b93d3393e3ded201828318ffede58d" alt="Cursor 配置截图 3" width="1200" height="800" data-path="images/integrations/cursor/api-config.png" />

### 步骤 4

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/api-model.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=3873a6652258b5fdc2d69c187ac4ef8c" alt="Cursor 配置截图 4" width="1200" height="800" data-path="images/integrations/cursor/api-model.png" />

### 步骤 5

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/ai-chat.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=f4a0d30ac8b54e71e35c8d240cbb24cd" alt="Cursor 配置截图 5" width="1200" height="800" data-path="images/integrations/cursor/ai-chat.png" />

### 步骤 6

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/autocomplete.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=e8447ebaf4ed2e546cba8abbbbb09a0a" alt="Cursor 配置截图 6" width="1925" height="1025" data-path="images/integrations/cursor/autocomplete.png" />

### 步骤 7

<img src="https://mintcdn.com/lingquai/Twqr-r52XykGBMod/images/integrations/cursor/quick-edit.png?fit=max&auto=format&n=Twqr-r52XykGBMod&q=85&s=86f8c8a97c321726b35d385cb6b13474" alt="Cursor 配置截图 7" width="1920" height="1031" data-path="images/integrations/cursor/quick-edit.png" />

## 常见问题

### 返回 401 或认证失败

确认 API Key 已完整复制，前后没有多余空格，并且已经在 APIAny.AI 控制台中启用。

### 模型无法选择或调用失败

手动输入模型 ID，并确认该模型在 [模型目录](/zh/models/chat-models) 中可用。不同工具可能不会自动拉取模型列表。

### Base URL 应该怎么填

OpenAI 兼容配置通常使用 `https://apiany.ai/v1`；Claude 兼容配置通常使用 `https://apiany.ai`；需要完整接口地址的工具使用 `https://apiany.ai/v1/chat/completions`。