搜「deepseek 使用的模型教程」的人,多数是在一个具体动作上卡住的:想调接口,却分不清自己要的是哪一档模型;网页版能用,换到代码里就报错。这篇不铺概念,按你实际会遇到的顺序拆——先确认入口,再确定模型,再看参数和额度,最后给一份出错时的排查顺序。每一步都给判断标准,也写清什么情况下这套走法不适用。
搜「deepseek 使用的模型教程」的人,十个里有八个不是卡在写代码上,是卡在更前面的地方:打开网页能用,复制一段示例代码跑就报错;或者听说某个档位厉害,接进去发现慢得离谱。这类问题多半不是模型的问题,是你把入口、模型、参数三件事搅在一起了。
这篇按你实际会遇到的顺序拆:先确认自己在哪个入口,再定用哪一档,然后看第一次调用要填什么,参数怎么一层层加,额度限制怎么看,最后给一份出错时的排查顺序。每一步都给判断标准,也写清什么情况下这套走法不适用。数字类的信息一概不写死,都告诉你去站内哪一页核对当时的数字。
先分清你在哪个入口用 DeepSeek
入口这件事听着废话,实际是最容易翻车的地方。官方网页或 App、官方 API、第三方中转或聚合平台,这三条路看着都叫「用 DeepSeek」,但模型名怎么写、额度怎么算、报错长什么样,三套体系完全不一样。你拿网页版看到的名字去填 API 的 model 字段,大概率直接报模型不存在。
- 官方网页或 App
- 只聊天、写东西、偶尔传个文件,用这个最省事,不用管 key 和参数
- 官方 API
- 要接进程序、批量处理、嵌到自己产品里,走这条,需要 key 和 base_url
- 第三方中转或聚合
- 想一个地方试多家模型、或者有网络和支付上的实际约束时才考虑,多一层中间人
判断标准很直接:只聊天就别碰 API;要写进代码就走官方 API;确实需要横向对比多家、或者团队有网络层面的限制,再看聚合平台。还有一种情况要先排除——如果你们团队已经有内部网关,别自己再开一路,先问清走哪个域名、哪把钥匙,自己另开一套最后对账会对到崩溃。
模型档位怎么定,别照着别人的截图抄
选档位最容易犯的错,是看别人截图里写了个名字就照抄。别人的截图对应的是他的任务,你的任务是改写一段文案,那用高配档只是多等几秒多花钱,结果未必更好。先按任务形态分两类:要推理过程的,比如数学、逻辑、多步分析、复杂代码;要快出结果的,比如改写、摘要、信息抽取、格式转换。
- 判断依据是任务形态,不是名字听起来高不高端;同一件事用高档位往往只是多花时间
- 一次要处理很长的材料,先看上下文长度限制,档位再高也顶不住长度不够
- 格式固定、要稳定复现的活,优先选输出可预期的档位,别选爱发挥的
- 拿不准就两个候选各跑一遍,比谁一次就能给出能直接用的结果
验证方法也简单:找一段你真实工作里的材料,同样的输入在两个候选档上各跑一次,别看谁写得花哨,看谁一次就能用、不用你回头改。具体有哪些档位、各自什么规格和单价,到 /official-api/providers/deepseek 核对当时的数字,别拿本文当价目表。
这套比法不适用的情况也得说清:如果你要的是大批量任务的成本可控,单条对比意义不大,得先估算输入输出长度再算总量;如果任务本身对延迟敏感,比如要嵌在实时对话里,那速度和稳定性的权重就压过效果,得换个比较维度。
第一次调用要填的那几个格子
第一次调用失败,十次有六七次不是代码逻辑错,是填错了格子。最常见的两个:base_url 末尾多写或少写一段路径,比如该带版本段的地方没带;model 字段照抄了网页版界面上显示的名字,而接口认的是另一套写法。这两个错报出来的信息还都挺像「模型不存在」,容易误判成账号问题。
- 先跑最短请求就给一句话,确认网络通、key 有效、模型名对。这一步别加任何业务内容,跑通了再往下加。
- 把 key 挪出脚本第一次图快写死在代码里没问题,但提交或分享前必须换成环境变量,不然迟早泄露。
- 只盯三处内容请求体里真正影响结果的只有三样:给它的材料、要它做什么、能接受多长的回复,其余先别碰。
- 报错先对参数名参数拼写和嵌套层级对不上,到 /ai-dict/category/basics 逐项对照,别靠猜。
如果你用的是聚合或中转平台,还要多确认一件事:它的模型名映射是怎么写的。同一家上游在不同平台上的名字可能不一样,文档里通常有一张对照,先查那张表再填,能省掉一轮瞎试。
参数一层层加,别一次配满
很多人第一次调接口,把温度、输出长度、各种开关一次性全填上,然后结果不对就懵了,因为分不清是哪个参数干的。稳妥的做法是先固定输出长度上限,再动温度,一次只改一个。改完跑一次,记下来改了什么、结果哪里变了。
| 想达到的效果 | 先动哪个 | 注意 |
|---|---|---|
| 结果要稳定、格式固定 | 温度调低 | 同样的输入多跑几次应该差不多 |
| 要发散、要多种写法 | 温度调高 | 同一问题两次结果不同是正常的,别当成 bug |
| 回复被截断 | 调输出长度上限 | 先确认是不是长度卡住,不是模型不会写 |
| 同样的活每次风格飘 | 固定提示词开头 | 把给谁看、要多长、不能出现什么写死 |
这张表是排查方向,不是配置模板,具体取值范围各家文档写得很清楚。两三轮基本就能摸到手感。这里也有不适用的情况:如果你在做的是需要严格可复现的任务,比如批量抽取字段,那温度就别去试高了,直接压到最低,把精力放在提示词和输出格式约束上。
额度和限制这一块,先看口径再看数字
网页版的可用次数、API 的按量计费、第三方平台自己定的限额,是三套完全不同的东西。混着算一定算错,而且错得还很自信。报错提示往往就一句话,你得先判断它属于哪一类:余额不足、并发或频率限制、还是单次请求长度超限。这三类的处理方式完全不同,一个是充值或换钥匙,一个是降速排队,一个是拆短输入。
还有一点:别拿别人截图里的余额去推导自己的花费。用量跟输入长度和调用次数直接挂钩,同一句话问十遍和问一遍,账差十倍。具体单价、计费单位和规格,到 /official-api/providers/deepseek 看当时的数字;想按自己的用量估总量,用 /tools/model-cost-calculator 把输入输出长度填进去算。
跑不通时的排查顺序
报错的时候最忌讳的动作是立刻换个平台重来。你换了平台,原来那个错还在,只是被掩盖了,下次换个地方又冒出来。按下面这个顺序走,四步之内基本能定位。
- 查连通域名和路径对不对,能不能拿到任何响应,哪怕是报错响应也说明网络通了。
- 查身份key 前后有没有空格、有没有过期、是不是另一个平台发的钥匙,这几个错最隐蔽。
- 查请求内容model 名拼写、消息结构、输入长度有没有超限,逐项对文档。
- 查账户状态余额、并发数、调用频率,看是不是被限流而不是真出错。
四步都过了还跑不通,再去 /ai-status 看有没有服务侧波动,或者到 /sites 看看同类服务的状态。顺序别反,先怀疑自己的配置,再怀疑平台。
什么情况下这套走法不适用
上面整套是按「一个人第一次接通、单条请求跑通」写的。以下几种情况得换思路,硬套这套会浪费时间。
- 要批量跑几万条:得先做并发控制和失败重试,单条跑通不代表扛得住量,先小批量压一轮再放量
- 数据不能出内网:官方接口这条路本身就不合适,得看本地或私有部署方案,别在接线上纠结太久
- 需要长期对账:官方和中转两套账要对齐口径,到 /prices 把计费方式比对一遍再定
- 团队共用一把钥匙:得有调用记录和额度分配,不然出问题查不到是谁在用
动手之前还有个小动作值得做:拿一句话写下「这次要解决什么事、什么结果不能接受」。写不出来,说明你还没想清楚要接哪个入口、用哪一档,那就先别开 key,想清楚再动手比跑十次 demo 都省时间。
去核对当时的数字档位、规格、单价这类会变的信息,本文一个都没写死。先去服务商页把当前的口径看清楚,再决定用哪一档、走哪个入口。→常见问题
DeepSeek 网页版和 API 用的模型是一回事吗?
不完全是一回事。网页版是产品层,内部会做路由和预处理,你看到的表现不能直接当成 API 的行为来预期。API 侧你填哪个 model 名,就只跑那一档。所以网页上跑得好的提示词,迁到接口后建议再验一遍,别默认等价。
model 名从哪里抄最稳?
别从别人的教程截图里抄,模型名会更新。最稳的是看官方文档或站内 /official-api/providers/deepseek 当前列出的名字,复制后不要手改大小写和下划线。拼错时通常不是报格式错误,而是提示找不到模型,容易误判成 key 有问题。
第一次调用报错了,先改代码还是先改配置?
先改配置。绝大多数第一次失败都出在 base_url 路径、key 有没有多余空格、model 名拼写这三处。代码逻辑出问题一般表现为能返回但结果不对,而不是直接报错。先把连通性跑通,再谈提示词和参数。
要不要一开始就配温度、top_p 这些参数?
建议先只设输出长度上限,其余用默认值跑一遍看基线。有了基线才知道调参是变好还是变坏。等你能稳定复现同一个任务的结果,再一个个加参数,每加一个跑两三次对一下差异。
额度用得快,是模型选贵了吗?
先分清是调用次数多还是单次输入长。长材料反复贴进去,输入侧消耗会比你以为的大得多。判断方法很简单:把同一次任务换短一点的输入再跑,看消耗变化。具体单价到 /official-api/providers/deepseek 核对当时的数字,别凭印象算。