Cursor

适用说明

Cursor 一般通过 OpenAI 兼容接口接入自定义模型服务，因此最关键的是确认：

1. API 网关域名
2. OpenAI Base URL
3. 可用令牌
4. 后台开放的模型名称

文档站域名和 API 地址可以分开配置。

配置建议

在 Cursor 的模型或提供商设置中，填写以下信息：

• API Key：sk-your-token
• Base URL：https://api.example.com/v1
• Model：后台可用模型名

如果你的界面支持自定义 OpenAI Provider，一般直接按这个方式接入即可。

建议的连通性测试

curl https://api.example.com/v1/models \
-H "Authorization: Bearer sk-your-token"

安装之后的检查

curl https://api.example.com/v1/models \
-H "Authorization: Bearer sk-your-token"

连接建议

• 优先用 /v1/models 或 /v1/chat/completions 验证接口
• Base URL 通常填写到 /v1
• 模型名不要照抄示例，要以后台真实配置为准

常见排查

1. 保存后没有模型

说明 /v1/models 没有返回可见模型列表，或者令牌权限不足。

2. 能看到模型但对话失败

优先检查该模型是否真正支持你当前使用的功能。

3. Base URL 填成根域名后失败

对于 OpenAI 兼容模式，通常需要填写到 /v1。