Cursor配置自定义API后模型列表不显示,说明Base URL、API Key或模型名至少一项未通过服务端校验,导致/v1/models请求失败或返回空列表;需依次验证API连通性、Base URL格式(仅协议+域名+/v1)、模型ID与文档完全一致,并强制刷新模型列表及彻底重启客户端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Cursor配置自己的API后模型列表不显示,说明Base URL、API Key或模型名中至少有一项未通过服务端校验,导致/v1/models请求失败或返回空列表,此时界面不会报错但直接静默过滤掉所有模型。
先验证API本身是否通
打开终端,执行以下命令(将your_api_key替换成你实际的Key):
curl -X GET "https://api.deepseek.com/v1/models" -H "Authorization: Bearer your_api_key" -H "Content-Type: application/json"
如果返回{"error": {"message": "Invalid API key", ...}},说明Key无效或格式错误;如果返回空数组{"data":[]},说明该Key没有模型权限;如果返回404,说明Base URL少写了/v1或写成了/v1/models。
这一步必须做,否则后续所有配置都是徒劳。
检查Base URL填写是否合规
进入Cursor → Settings → Models → Add Model → Provider选择“OpenAI Compatible”。
在Base URL栏中,只填协议+域名+/v1,例如:https://api.deepseek.com/v1。
【不要填https://api.deepseek.com/v1/chat/completions,也不要填https://api.deepseek.com】
Cursor会在运行时自动拼接路径,多填或少填/v1都会导致模型列表请求被服务器拒绝或重定向失败。
统一LLM网关 - 一个API对接70+AI模型,使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
确认模型名是否与服务商文档完全一致
方法一:直接复制服务商控制台“支持模型”页面中的模型ID
例如DeepSeek官方文档明确列出deepseek-chat和deepseek-v4-pro,就不能写成deepseek_chat或deepseek-v4-pro-2026。
方法二:用curl调用/v1/models接口后,从返回JSON的data[].id字段里逐字复制
注意大小写、连字符、版本号——哪怕多一个空格或换行符,Cursor都无法匹配成功。
强制刷新模型列表并重启客户端
第一步:点击Settings右上角的“⟳ Reload Models”按钮(若不可见,说明当前Provider尚未保存)
第二步:关闭Cursor所有窗口,包括后台进程(macOS可在活动监视器中查杀Cursor进程,Windows可在任务管理器中结束“Cursor.exe”及其子进程)
第三步:重新启动Cursor,等待约8秒——模型列表不是即时加载,而是异步拉取,过早查看会误判为失败。
这一步不做,即使配置全对,模型也不会出现在下拉菜单中。

















