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

# Cursor

> 将 Cursor 指向 FlexInference，并使用带有截止日期的代理密钥。

Cursor 将聊天补全发送到您设置的任何基本 URL。集成只需两个字段和一个模型名称。

Cursor 没有提供设置 `start_within` 的地方，因此截止日期会附加到密钥上。请先创建一个密钥（参见[代理密钥](/zh/agent-keys)）。

选择一个层级而不是 **Flex race**。Cursor 发送的 Chat Completions 参数会被 race 拒绝，下面的故障排除会解释原因。

Cursor 将这些设置保存在其自己的 UI 中，无需编写配置文件，因此本页没有代理设置提示。以下步骤手动操作不到一分钟即可完成。

## 配置 Cursor

1. 在 macOS 上使用 `Cmd+,`，或在 Windows 和 Linux 上使用 `Ctrl+,` 打开 Cursor 设置。

2. 点击侧边栏中的 **Models**。

3. 启用 **Override OpenAI Base URL**。输入路由器 URL，包括 `/v1` 后缀。

   ```text theme={null}
   https://api.flexinference.com/v1
   ```

4. 将您的代理密钥粘贴到 **OpenAI API Key** 字段中。

   ```text theme={null}
   flex_live_...
   ```

5. 将 `gpt-5.6-sol` 添加到模型列表中。Cursor 会将此名称原样发送给我们。

6. 点击 **Verify**。

Cursor 会将 `/chat/completions` 附加到基本 URL，并将密钥作为 bearer token 发送。密钥提供了截止日期。

## 确认密钥已应用

每个响应都带有 `x-flexinference-defaults-applied`。Cursor 不显示响应头，因此请改为在仪表板的 **Logs** 下查看请求。

## 故障排除

**每次请求都出现 [`400 unsupported_parameter`](/zh/errors#unsupported_parameter)。** Cursor 发送了一个我们不翻译的 Chat Completions 参数，并且对于非 OpenAI 模型，我们会拒绝其中任何一个。请切换到 `gpt-*` 模型。完整列表包括 `seed`、`stop`、`presence_penalty`、`frequency_penalty`、`logit_bias`、`logprobs`、`top_logprobs`、`prediction`、`audio`、`modalities` 和 `web_search_options`。

**[`400 key_default_not_applicable`](/zh/errors#key_default_not_applicable)。** 您的密钥包含一个持续时间，而 Cursor 在其旁边发送了其中一个参数，这与 flex race 不兼容。请将密钥编辑为 **Standard**、**Priority** 或 **Auto**。

**一个看起来不像我们的 `401` 错误。** 基本 URL 为空或错误，因此 Cursor 将您的密钥发送到了 `api.openai.com`，而 OpenAI 拒绝了它。请同时设置基本 URL 和密钥字段。

**Claude 模型上出现 `422` 错误。** 这不是我们返回的拒绝。我们通过将请求转换为 Anthropic 的 Messages API 来在 Chat Completions 上运行 `claude-*`，前提是请求体中没有原生的 Chat 参数。Cursor 自己的 Claude 路径通过被覆盖的基本 URL 会在其一侧以这种方式失败。请使用 `gpt-*` slug 继续，或者直接向我们发送相同的请求，以查看是哪一方拒绝了它。

**Claude 昨天还能用，今天却出现 `422` 错误。** 在 Cursor 中开启 Anthropic BYOK 也会在不告知的情况下开启基本 URL 覆盖。请关闭其中一个。

**Tab 自动补全从未出现在您的日志中。** Cursor 在其自己的后端运行 Tab，并且覆盖仅适用于聊天。没有问题。

**`Verify` 通过但请求仍然失败。** **Verify** 检查密钥格式和端点是否响应，而不是每个功能路径。请发送一个聊天请求来检查它是否有效。

有关我们返回的所有拒绝，请参阅[错误](/zh/errors)；有关非 Cursor 特有的拒绝，请参阅[代理密钥](/zh/agent-keys)。