很多人是这么卡住的:搜到一篇说 DeepSeek 有免费额度,注册完拿到一串 Key,粘进代码里却不知道填哪个模型名,换了几个都报错,最后怀疑是不是 Key 没生效。这篇不讲协议原理,也不讲客户端怎么配,只讲两件事——免费 Key 从哪拿、拿到之后按什么标准选模型,以及一条从「Key 到手」到「第一次调通」的最小验证路径。
很多人是这么卡住的:搜到一篇说 DeepSeek 有免费额度,注册完拿到一串 Key,粘进代码里却不知道填哪个模型名,换了几个都报错,最后怀疑是不是 Key 根本没生效。问题往往不在 Key,而在两件事没分清——这串 Key 是从哪来的,以及你打算让它干哪种活。
这篇不讲协议原理,也不讲客户端怎么配,只讲两件事:免费 Key 从哪拿、拿到之后按什么标准选模型,再给一条从「Key 到手」到「第一次调通」的最小验证路径。半小时内跑通是能做到的,前提是按顺序来,别一次改好几处。
免费 Key 从哪领,先分清三种来源
免费 Key 不是一种东西,来源不同,你后面踩的坑也完全不同。先定性,再决定要不要花时间。
- 官方平台免费额度
- 注册后在控制台生成 Key,额度、有效期、是否要实名,都以站内官方 API 页当页写的口径为准,别照抄别人截图里的数字。
- 中转站 / 聚合平台免费位
- 注册即送或签到送,门槛低,适合先跑通流程;但稳定性差异极大,用之前先过一遍可信度检测。
- 本地推理的「伪免费」
- 用 Ollama 这类在本地跑,不花 API 钱,但吃显存和电,只有你本来就有机器时才划算,本质上是自建而不是领 Key。
三种来源的判断标准很简单:只是想验证代码跑不跑得通,先用中转站免费位;要进正式项目,回到官方额度或付费口径。中转站那部分不要只看它送多少,先看它靠不靠得住,检测口径和站点清单到 /sites 和 /tools/verify 对照着看,通过率低的直接跳过。
- 只想跑通一次请求:任选一种来源都行,重点是把流程走完,别纠结额度
- 打算写进小工具长期用:优先官方额度,避免中途被掐
- 多人协作或要分享给同事:避开需要人手注册签到的中转站免费位
- 已经在本地有显卡:先把本地推理当备选,省得来回申请
- 分不清某站是否靠谱:先查可信度检测结果,再决定注册
选模型别看名字看三件事
拿到 Key 之后最容易出错的一步,就是模型名。名字看着差不多,能力定位可能完全不同,填错直接报错,或者更糟——能返回但答非所问。选之前先过三件事。
| 判断维度 | 怎么确认 | 什么情况下不适用 |
|---|---|---|
| 任务类型 | 写代码、长文总结、结构化输出对模型要求不同,别拿通用对话模型硬扛代码补全 | 任务跨多类、想一个模型全包时,往往哪类都不拔尖 |
| 接口兼容性 | 按 OpenAI 兼容那套填,请求体形状到站内 API 分类页对照,别自己猜字段 | 用了非兼容的自定义封装时,字段名要按该封装自己的文档来 |
| 额度与限速 | 到官方 API 页和用量页对一遍当时的并发、频率口径 | 需要稳定高并发时,免费档基本都不适用 |
想横向比能力,别凭印象,到 /models 和 /benchmarks 看当时的榜单数据;想确认接口填法,到 /ai-nav/category/ai-api 对着来。这些页面的数字都会更新,看当页的,别用缓存里的旧结论。
一个常见的不适用场景:如果你的任务是长上下文文档问答、多轮工具调用,免费档通常撑不住,这时候该考虑换方案而不是继续调参。调参调不出档位差。
拿到 Key 后的最小验证流程
下面这条路径的重点是「一次只改一个变量」。跑通了再往上加复杂度,出错时你才知道是哪一层的问题。
- 先测网络基线用站内测速工具跑一下你到该接口的延迟,知道自己的网络底子,后面报错时才能分清是网络问题还是代码问题。
- 发一条最短请求只要能返回内容,就说明 Key 和模型名都对了。先别上完整业务逻辑,把变量压到最少。
- 逐层加复杂度先加系统提示,再加多轮对话,最后才加流式或结构化输出。每加一层单独验证一次。
- 记录三个值请求耗时、返回的 token 数、是否命中限速。攒几天就能看出你这套用法该不该换模型或换渠道。
- 把 Key 直接写进前端代码,等于公开
- Base URL 和模型名混着改,出错后分不清是哪边
- 一次改好几处再运行,报错信息对不上改动
- 只看「有没有返回」,不看返回内容是否真的符合预期
- 跑通一次就当稳定,没做重复调用测试
什么情况下免费档就该放弃了
免费档不是不能长期用,而是有明确的使用边界。触到下面几条,说明该换方案,而不是继续优化。
- 连续限速,重试也恢复不了,说明请求量已超出免费档的设计范围
- 要上线上功能、要求稳定低延迟时,免费档的排队和抖动没法通过优化解决
- 需要用固定模型版本做回归测试时,模型可能调整,昨天通过的用例今天结果变了,这种不确定性写不进测试基线
判断动作很具体:翻一下 /usage 和 /price-watch,看你这个用量对应的实际开销,心里有数之后再决定是升级、换渠道还是改架构。三条路没有绝对优劣,取决于你的量和稳定性要求。
下一步先确认你手上的 Key 是哪一类来源,再到站内把模型名和接口字段对齐,然后按验证流程跑一遍最短请求。全程数字以页面当时的记录为准,别用别人截图里的值。→常见问题
免费领到的 Key 和付费的有什么区别?
主要是额度上限、并发限制和稳定性,接口本身通常是同一套。免费档更容易被限速、排队时间更长,模型可选项也可能更少。具体哪些模型在免费档可用、额度多久重置,去站内官方 API 页面看当时的口径,别用别人几个月前的截图做判断。
模型名填错了会报什么错?
多数情况会返回找不到模型或参数相关的错误,而不是鉴权错误——这点很重要,因为很多人一看报错就去换 Key,其实 Key 是好的。排查顺序是先确认请求体结构和字段名,再确认模型名是否在可用列表里,最后才怀疑 Key。相关思路可以对照 401 和 403 的区别那篇看。
免费档能直接上生产吗?
要看你的容错能力。内部工具、个人项目、跑批任务通常可以,用户直接等的线上功能不建议,因为限速和延迟抖动会让体验崩掉。想上生产至少要做到:有限速重试、有备用渠道降级、有日志能复盘每次请求的耗时和消耗,这几件事缺一件都容易出事。