硅基流动接入 Cursor 怎么配？基址、模型名与报错对照

数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。

把硅基流动接到 Cursor 这类支持自定义 OpenAI 兼容端点的编辑器里，平台这一侧其实只需要三样东西填对：基址填 https://api.siliconflow.cn/v1、鉴权用 authorization: Bearer <你的 apikey>、模型名按平台的命名规则原样填（收费版比免费版多一个 Pro/ 前缀）。剩下的事情都是这三样填错之后的连锁反应——模型名错了回 Model does not exist，key 没设对回 401，没实名回 403，欠费回 402，调得太密回 429。所以配不通的时候别乱改，先把返回的 HTTP 状态码和 message 打出来，它基本能直接指向是哪一栏写错了。

需要先说清楚一件事：硅基流动的官方文档里，我们已核的页面（快速上手、错误码、限流与升级、财务、鉴权、常见问题）没有针对 Cursor 的专门接入章节。已核页面里唯一被点名的第三方客户端是 Cherry Studio，而且只出现在讲输出截断的那一段。所以这篇讲的是平台这一侧必须填对的东西，以及填错后平台会怎么回你；至于 Cursor 界面上那几个输入框叫什么名字、在哪个面板里、自定义模型对补全生效不生效，以 Cursor 官方文档为准，站内另有一篇 Cursor 自定义模型配置 专门讲编辑器那一侧。

平台这一侧只有三个字段

硅基流动的 API 基址是 https://api.siliconflow.cn/v1，聊天补全端点是 https://api.siliconflow.cn/v1/chat/completions。鉴权头官方写的是 authorization: Bearer <你的 apikey>，也就是标准的 Bearer 方案，没有额外的自定义头。

官方明确说明它同时兼容 OpenAI 与 Anthropic 的对话协议，大语言模型可以直接用 OpenAI 官方库调用，只需要把 base_url 指向上面这个基址——官方 Python 示例里就是 OpenAI(api_key=..., base_url="https://api.siliconflow.cn/v1") 这种写法，示例要求 Python 3.7.1 或更高版本。这一点决定了它能接进任何提供”自定义 OpenAI 兼容端点”配置项的客户端：客户端只要允许你覆盖基址和密钥，这一侧就没有额外适配成本。

API Key 在「API 密钥」页面新建，账号登录目前支持短信登录和邮箱登录两种。

一个容易被忽略的细节是基址末尾那个 /v1。不同客户端对”基址”的定义不一样：有的要求你填到 /v1 为止、由客户端自己拼上 /chat/completions，有的要求填完整端点。官方给出的这两个地址正好覆盖了这两种情况，填之前先看清楚客户端那个输入框旁边的提示要的是哪一种，别自己拼一个既不是基址也不是完整端点的中间形态。

模型名是最容易填错的一栏

这是接编辑器时最容易配完一调就报错的地方。

官方的命名规则是：部分模型同时提供免费版和收费版，免费版按原名称命名，收费版在名称前面加 Pro/ 前缀。这两个名字指向的是同一个模型的不同档位，不是两个模型。除了计费口径不同，两者在限流上也不一样——免费版的 Rate Limits 是固定的，收费版的 Rate Limits 会随账户用量级别变化。

更需要留意的是 DeepSeek 系列：官方单独说明 DeepSeek R1 与 V3 按支付方式区分命名，Pro/ 版仅支持充值余额支付，非 Pro 版支持赠费余额和充值余额支付。也就是说，你在编辑器里填哪个名字，不只是决定贵不贵，还决定了这次调用能不能从赠费余额里扣。如果你手上主要是赠费余额，却填了带前缀的那个名字，这笔钱就用不上；至于平台此时具体返回什么，官方文档未作说明。

模型名填错时，平台返回的错误响应形如 {"code":20012,"message":"Model does not exist. Please check it carefully.","data":null}（错误码取值以官方文档当前版本为准）。这条 message 说得很直白，但在编辑器场景里它常常被折叠在某个不显眼的提示条里，只显示一句笼统的”请求失败”。所以第一次配完之后，最好先用 curl 或者一小段 Python 直接打一次同样的模型名，确认名字本身是对的，再回到编辑器里排查其余环节——这样能把”名字写错”和”客户端没把配置传对”这两类问题分开。

模型名和限额的具体对应关系，官方让你去模型广场查，而不是在文档里维护一份清单。这个安排是合理的：模型上下架比文档更新频繁，文档里写死的清单一定会过期。

403 往往不是权限配错，而是没实名

这是接编辑器时最容易撞上、却最难联想到的一道门槛，因为你在客户端里看到的只是一个 403，很难联想到实名认证。

官方错误码表对 403 的解释是权限不够，最常见的原因是该模型需要实名认证，其他情况看 message。而实名认证这件事在这个平台上的分量比想象中重：依据《中华人民共和国网络安全法》等法规要求，不实名就无法充值、也无法申请开票，并且实名之后才能使用全部免费模型。

认证分个人和企业两类，账号归属和开票资质都由认证类型决定——企业认证可以开增值税专用发票与普通发票，个人认证只能开个人抬头的增值税普通发票；官方明确提醒企业用户不要去做个人实名认证，而且一个账号只允许绑定一个认证主体。个人认证支持的证件包括身份证、港澳往来大陆通行证（回乡证）、台湾往来大陆通行证（台胞证）、港澳居民居住证、台湾居民居住证、外国人永久居留证（证件清单以官方文档当前版本为准），没有这些证件的暂不支持线上认证；个人认证走支付宝 App 扫码人脸识别。企业认证则有法人人脸识别和企业对公打款两种方式，对公打款是平台打一笔小额随机金额、你回填金额完成核验。

认证信息在 30 天内只能完成一次变更或修改，官方还写明不对未成年人提供在线实名认证服务。前一条意味着认证主体这件事要一次想清楚：如果你是先用个人身份认证、后来才发现需要开专票，就要等这个窗口过去才能改。

配不通时，按状态码倒推

把官方错误码表当成一张”哪一栏填错了”的对照表来用，比逐项重填快得多（以下含义以官方文档为准）：

• 400：参数不正确，按 message 修正非法的请求参数
• 401：API Key 没有正确设置——对应到编辑器场景，通常是 key 粘贴时带了空格换行，或者客户端把它拼进了错误的头
• 402：账户欠费，充值后重试
• 403：权限不够，最常见是该模型需要实名认证
• 429：触发了 rate limits，按 message 判断具体是 RPM/RPD/TPM/TPD/IPM/IPD 中的哪一种
• 503 / 504：服务负载较高，稍后再试；对话与 TTS 请求可以尝试改用流式输出
• 500：未知错误，需要联系官方排查

官方还给了一套通用排查步骤，顺序值得照抄：① 把错误码和 message 打印出来；② 用 curl 复现一次；③ 换一个模型试试；④ 如果开了代理，关闭代理再试。

最后这条在编辑器接入场景里命中率不低，但很少有人第一时间想到——很多人为了用别的服务常年挂着代理，代理链路把请求转到了别处，症状看起来却像是 key 或者基址填错了。用 curl 复现那一步的价值也在这里：它把编辑器这一层完全排除掉，能立刻判断问题出在平台侧还是客户端侧。

还有一个专门的情况：已经充值成功却仍提示余额不足。官方给的排查方向是先确认 api_key 是否与刚充值的那个账户匹配（多账号的人很容易充到另一个账号上），其次可能是网络延迟，等几分钟再试。

限流是按账户算的，多建几把 key 没用

编辑器接入之后调用密度会明显高于手写脚本，所以限流规则要提前知道。

硅基流动的限流一共有七种指标（清单以官方文档当前版本为准）：RPM（每分钟请求数）、RPH（每小时请求数）、RPD（每天请求数）、TPM（每分钟 token 数）、TPD（每天 token 数）、IPM（每分钟图片数）、IPD（每天图片数）。

关键是这三条规则：

第一，任一指标先达峰即触发，不需要全部达标。官方举的例子很清楚：假设 RPM 和 TPM 各有一个上限，你在一分钟内发了一批很短的请求，请求数先撞到 RPM 上限，那么即使 token 用量离 TPM 上限还差得远，限流照样会触发。编辑器里的补全和短问答正是这种”请求多、每次 token 少”的形态，所以更容易先撞 RPM 而不是 TPM。

第二，Rate Limit 定义在用户账户级别，不是 API key 维度。 这条经常被反向理解——有人为编辑器单独建一把 key，以为能拿到一份独立的额度，实际上不会，同一个账户下多建几把 key 也是共用同一份限额。

第三，每个模型单独设置限额，一个模型超限不影响其他模型。 所以撞限流的时候，换一个模型继续干活是官方规则支持的做法，比干等更划算。

免费模型的限额是固定值；收费模型按账户用量级别分层，级别越高限额越宽。用量级别按月消费金额划分（含充值消费与赠送金额），取「上月」与「当月 1 号至今」两者的最高值来换算，达标即自动升级、立即生效，新用户从最低档开始。具体的门槛金额和各档限额数值这里不列，因为平台会调整，去官方定价与限流页看当前值。

触发 429 时官方返回的原文是 Request was rejected due to rate limiting. If you want more, please contact contact@siliconflow.cn，处理方式是等待后重试，官方推荐指数退避。限流指标本身的含义可以看站内的 RPM 与 TPM 到底限的是什么，429 的通用退避写法看 429 报错的通用处理。

另外，如果你用的是专属实例，官方说明专属实例用户通常无限额，出现 429 要先确认两件事：是否调用了专属实例的正确模型名，以及 api_key 是否与该专属实例匹配。

长对话被截断，先看 max_tokens

编辑器里塞的上下文往往比手写脚本大得多，输出被砍一半是常见抱怨。官方给的排查方向有三条。

一是 max_tokens 的设置是否合适。官方说明 max_tokens 与上下文长度相等，并且提醒不要把它设成最大值，要给输入内容留出余量——部分模型的推理服务处于更新中，顶满反而容易出问题。

二是非流式的长输出容易超时，触发 504，改成流式输出可以规避。

三是客户端侧的超时时间要调大。第三方客户端这一层也可能自带限制：官方举的例子是 Cherry Studio 有一个默认的消息长度限制，需要先打开「开启消息长度限制」开关才能调整。这个例子本身讲的是 Cherry Studio，但它提示了一个通用的排查方向——客户端可能在你不知情的情况下替你设了一个 max_tokens，平台侧怎么调都没用。换到任何编辑器客户端上，都值得先去它的模型配置里翻一遍有没有类似的开关。

还有一类和截断无关但表现相似的问题：部分模型在不设参数时容易输出乱码，官方给的方向是尝试设置 temperature、top_k、top_p、frequency_penalty。如果你看到的不是被砍断而是后半段变成了乱码，往这个方向调而不是去改 max_tokens。

最容易栽的坑

按上面这些规则倒推，接编辑器时真正高频的坑其实只有三个：模型名的 Pro/ 前缀写没写对（它同时决定计费档位和能不能用赠费余额）、没实名导致的 403 被误判成 key 问题、为客户端单建一把 key 却以为拿到了独立额度。这三条都不是代码问题，看错误码之外的任何东西都排查不出来。

配完第一件事：用 curl 打一次同样的模型名和同一把 key，确认平台侧是通的。这一步能省掉后面一大半的猜测。平台整体的接入流程和模型命名空间规则，可以对照站内的 硅基流动 API 接入 一起看。