SETUP GUIDE · CURSOR
在 Cursor 里用自定义 API Key 和 Base URL
一句话回答
打开 Cursor 设置的 Models 页：在 API Keys 区域把 OpenAI API Key 填成在
JiuRelay 首页免费领取的 Key，勾选 Override OpenAI Base URL 填
https://jiurelay.com/openai/v1，再用 Add model 添加自定义模型
5.2（Free 线路）或 grok-4.5（Grok 线路），
在 Chat 里选中该模型即可对话。全程无需注册、无需绑卡。
Key 有效期 Free 3 小时、Grok 2 小时，有效期内不设 token 与次数上限；
需要在领取后 15 分钟内完成首次调用，否则会被自动吊销。
注意：自定义 Key 只作用于 Chat 类功能，Tab 补全仍走 Cursor 官方模型。
配置参数速查
SETTINGS → MODELS → API KEYS
- OpenAI API Key
- 首页一键领取的免费 Key
- Override OpenAI Base URL
模型列表（ADD MODEL）
- Free 线路
5.2· 对应首页 Free 线路的 Key- Grok 线路
grok-4.5· 对应首页 Grok 线路的 Key
只勾选自定义模型：开启自定义 Key 后，把 gpt-4o 等官方模型全部取消勾选，避免请求打到本站不存在的模型上报错。
本站提供 OpenAI 协议兼容端点，并非 OpenAI / Cursor 官方接口；实际可用模型以接口实时返回为准。
四步配完
填 Key 和 Base URL
Settings → Models → API Keys，填 Key 后勾选 Override OpenAI Base URL 填入上表地址。
添加自定义模型
Add model 输入 5.2 或 grok-4.5，取消勾选其他官方模型。
15 分钟内试跑
Chat 里选中自定义模型问一句话。超过 15 分钟没调用，Key 会被自动吊销。
常见问题
带。填 https://jiurelay.com/openai/v1，与 OpenAI 官方端点格式一致，Cursor 会自己拼接 /chat/completions。末尾不要多加斜杠，也不要写成 /v1/v1 —— 表现都是 404 或验证失败。
按顺序查：① Key 是否复制完整；② Base URL 是否按上表原样填写；③ 模型列表里是否已添加并只勾选 5.2 或 grok-4.5 —— 勾着一堆官方模型时，验证请求可能打到本站不存在的模型上直接失败；④ Key 是否已过期（限时有效）。都确认后回首页重领一个再试。
这是 Cursor 的产品设计（见 Cursor 官方文档）：自定义 API Key 只作用于 Chat 对话类功能；Tab 补全、部分 Agent 能力由 Cursor 自家模型驱动，不走自定义 Key，仍按官方订阅规则运行。想要"全功能"的第三方接入，可以考虑 Claude Code、Codex 等 CLI 工具，配置后所有请求都走中转。
必须原样填 5.2 或 grok-4.5，且与所领线路的 Key 对应。开启自定义 Key 后建议只保留这一个模型：官方模型名在本站不存在，混着勾选后 Cursor 一旦调到官方名就会报模型不存在。
三个最常见原因：① Key 复制不完整或带了空格；② Key 已过期 —— Free 3 小时 / Grok 2 小时；③ 领取后超过 15 分钟没发起首次调用被自动吊销。回首页重新领取后，记得在设置里更新 Key。
限制只在时间上：Free 3 小时、Grok 4.5 2 小时，到期自动失效。不设 token 总量上限，也不设总请求次数上限。高峰时段共享额度可能临时限速（429），等几十秒重试即可。需要更长有效期可通过推广计划兑换 24 小时 / 7 天 / 30 天长效 Key。
Models 设置里关掉 OpenAI API Key 开关（或清空 Key 与 Base URL），重新勾选官方模型即可，配置随时可以再切回来。日常推荐两套并存：探索、问答走免费线路，重活切回官方订阅。