将 Cursor 接入 Scenepond
配置自定义 API 地址与模型，使用 Cursor 支持的聊天功能。
官方接入文档- API 地址
https://scenepond-api-production.up.railway.app/v1- API 协议
- OpenAI Chat Completions
- 模型 ID
YOUR_MODEL_ID· 填写模型目录中的完整 ID
Cursor 可以通过自定义 OpenAI 兼容接口使用所支持的聊天功能。手动添加 Scenepond 模型后，在 Chat 中选择该模型。
请先安装客户端并确认它能在本地启动。还需要 Scenepond 账户、已启用的聊天模型、具有相应权限的 API Key，以及足够支付首次请求的余额。
客户端安装与首次启动 ↗让你的编程智能体协助配置
将配置说明复制给你正在使用的编程智能体，其中包含接口地址与操作要求，不含 API Key。也可以按下方步骤手动配置。
请通过自定义供应商，将 Cursor 接入 Scenepond。 Scenepond 接入指南: https://open.scenepond.ai/zh/integrations/cursor 官方接入文档: https://cursor.com/help/models-and-usage/api-keys API 地址: https://scenepond-api-production.up.railway.app/v1 模型 ID: YOUR_MODEL_ID API 协议: OpenAI Chat Completions 先检查已安装的客户端版本和现有配置，保留其他供应商、智能体、消息渠道和设置。 仅用已启用且我的 API Key 有权限访问的 Scenepond 模型替换 YOUR_MODEL_ID。确认工具支持与实际上下文限制，不要虚构模型能力。 我会将原始密钥设置到 SCENEPOND_API_KEY 或客户端的安全凭据字段。不要让我把密钥粘贴到聊天中，也不要打印、提交到代码库或嵌入浏览器代码。 按 Scenepond 接入指南使用该客户端的供应商语法与密钥保存方式。使用以 /v1 结尾的基础地址和 chat completions 协议，填写 Scenepond 凭据，而非上游供应商凭据。 先在本地验证配置，发起付费 API 请求前请向我确认。如果缺少模型或凭据，说明需要补充的配置。不要自动重试请求。 说明修改了哪些设置、如何启动新会话，以及已验证和未验证的内容。
1. 准备模型与 API Key
从目录复制已启用的完整模型 ID，并创建具有相应访问权限的 Scenepond API Key。智能体任务需要确认模型支持工具调用；选择前请核对上下文限制和支持协议。
将 YOUR_MODEL_ID 替换为已配置的完整模型 ID。本指南配置聊天接口，图片或视频生成工具需单独接入。模型可用性与调用成功取决于后台配置和账户余额。
2. 配置自定义供应商
打开 Cursor Settings → Models → API Keys。将原始 Scenepond 密钥填入 OpenAI API Key，保存并启用。启用 Override OpenAI Base URL，填写下面以 /v1 结尾的地址。
- OpenAI API Key
- 你的 Scenepond API Key，无需填写 Bearer 前缀
- Override OpenAI Base URL
https://scenepond-api-production.up.railway.app/v1- Add Custom Model
YOUR_MODEL_ID
搜索完整的 Scenepond 模型 ID，选择 Add Custom Model 并启用。Cursor 不会通过 Refresh Model List 获取网关目录。填写基础地址，不追加 /chat/completions 或 OpenRouter 专用的 /cursor 后缀。
Cursor 自定义密钥不能替代其 Tab 自动补全模型。OpenAI 地址覆盖可能影响其他模型选择；切回与之冲突的 Cursor 托管模型时，请关闭 OpenAI 密钥。请求和凭据会经过 Cursor 服务，并非仅保存在本地的凭据流程。
Cursor 对 OpenAI 密钥明确说明了标准聊天支持。推理、视觉与工具兼容性需按所选模型分别核实，本指南不代表所有 Cursor 功能都可用。
3. 在 Chat 中选择模型
新建 Chat，选择刚添加的自定义模型。使用读取文件、修改代码或执行命令的 Agent 工作流前，先发送下面的简短测试。
官方自定义网关配置说明 ↗4. 核对返回结果与用量
确认客户端选中了 Scenepond 供应商和完整的模型 ID。在新会话发送下面这条简短消息，请求会使用账户余额。
不要调用工具，只回复 READY。收到文本回复后，打开 Scenepond 用量记录，核对模型、请求时间与实际结算费用。文本回复可确认基本聊天接入；工具与推理能力应在模型支持时分别测试。
常见配置问题
- 找不到密钥或凭据被拒绝
- 确认实际运行的客户端能读取原始密钥，且 Scenepond 密钥已启用。诊断输出中不要包含密钥。
- 模型不可用
- 检查模型目录中的完整 ID、密钥权限与余额。OpenClaw 的模型引用还需要加上 scenepond/ 前缀。
- 找不到自定义模型或内置聊天失败
- 手动添加并启用完整的自定义模型，在 Chat 中选中它。检查 OpenAI 地址覆盖是否影响了其他模型；切回与之冲突的 Cursor 托管模型时，请关闭该密钥。
- 聊天成功，工具调用失败
- 检查所选模型的工具支持和客户端的工具设置。文本聊天成功不能证明所有智能体能力都可用。