很多人问过我这个:模型名那一栏到底填什么。说实话,这个问题没有标准答案,因为 Cursor 只负责把模型名透传给服务端,服务端认什么,你就得填什么。我自己也遇到过因为模型名写错而反复折腾的情况,后来养成一个习惯:先查服务端的模型列表,再回来填。
先弄清请求发给谁
还要注意使用场景的区分。如果你连接的是DeepSeek官方API,模型名以官方文档为准;如果你是通过Ollama本地运行DeepSeek模型,那么在Cursor中要填入的是Ollama中的标签名称,比如“deepseek-r1:8b”,而不是“deepseek-chat”。如果你使用的是第三方代理或网关,模型名可能被映射成另一个名称,甚至需要加上前缀。因此,最先要弄清楚的是你的请求实际发送到哪个服务端。
所以第一步不是打开 Cursor 的模型设置,而是先看当前配置的 Provider 或 Base URL。你在 Cursor 里填写的模型名会被发送给这个地址指向的服务端,它按照自己的规则解析模型名。官方 API 和 Ollama 本地服务解析规则完全不同,第三方网关又可能加入自己的映射。如果你不看这一层,就算把名字填对了,也可能发现效果不对——比如某些网关在无法识别模型名时,会悄悄回退到默认模型,不报错,但对话结果和计费对象都不是你想要的。
官方 API 就按官方文档填
配置DeepSeek模型时,模型名填什么,取决于你使用的是DeepSeek官方API还是第三方服务。对于官方API,模型名是一个类似“deepseek-chat”的字符串,它必须与API请求体中的model字段完全一致。Cursor作为客户端,会将你填写的模型名直接透传给服务端,所以填错就会得到“model not found”之类的错误。判断依据很简单:打开DeepSeek开放平台的文档或模型列表,找到当前可用的model id,然后原样填入Cursor。
具体到操作,我会在 Cursor 的模型设置里手动添加模型,从官方文档或者模型列表页面复制 model id,然后粘贴进去。这里注意两个容易忽略的点:一是复制时不要带上网页里的隐藏字符,比如空格或换行;二是完全不要手动输入的“deepseek-v2”这类旧称呼。为了确认自己没看错,我会先打开 DeepSeek 开放平台,看它当前暴露的模型列表里实际写了什么。
填错时先看报错信息
常见的一个坑是,网络上的教程可能提到“deepseek-coder”或“deepseek-code”这样的模型名,但DeepSeek官方API可能已经不再使用这类名称,或者它们只存在于某个历史版本。如果照抄,请求会失败。另一个坑是大小写,模型名严格区分大小写,必须与官方文档一致。遇到问题先看返回的错误信息,如果提示“model not found”,立即检查模型名是否多一个空格或多了前缀。
除了模型名本身,还要留意报错是从哪一层返回的。Cursor 有时会把服务端的原始错误包装成一句“Something went wrong”,如果不点开详情,很难看出真正原因。这时候可以查看 Cursor 的日志,或者直接在终端里运行 Cursor 并观察输出。重点关注 HTTP 状态码:400 表示请求格式不对,最常见的就是模型名缺失或内容不合法;404 则表示服务端找不到这个模型,基本上就是模型名填错了。
配置后发一条消息验证
配置完成后,最直接的验证方式是在对话窗口发送一条任意消息。正常得到回复,说明模型名有效;如果收到类似“The model `xxx` does not exist”或“Invalid model”的报错,那就是模型名填错了。注意,报错信息可能会被Cursor的界面包装,点开错误详情或查看日志能定位到真实原因。不要忽略日志中的HTTP状态码,尤其是400或404。
如果你用的是 Ollama 本地服务,我建议先执行 ollama list 看看本地拉取到的模型标签,再回到 Cursor 填写。标签名和官方 API 的 model id 是两套体系,不能通用。例如你本地拉取的是 deepseek-r1:8b,就填它,不要想当然地填写 deepseek-chat。
保守一点,先查文档再动手
模型名是服务端的“菜名”,你只能点菜单上有的菜。在配置前花一分钟查阅官方 API 文档,比反复试错更有效率。如果文档里同时列出了多个模型(如对话模型和推理模型),请根据你的任务选一个,比如写代码时用对话模型,复杂推理时用推理模型,但这不是绝对的。保守起见,优先选择官方标注为“推荐”的模型名。
所以,这个问题的核心不在记住某个字符串,而在于搞清楚请求发往哪里。先确认服务端,再查模型列表,然后原样粘贴,最后发消息验证。这个流程走完,基本能排除九成以上的模型名配置问题。剩下的要么是 API Key 权限不对,要么是网络没有连通到目标服务端,那就该往另一个方向排查了。