很多人拿到 Key 之后第一件事就是找「填哪个网址」,结果在文档里翻到好几个长得很像的地址:有带版本的、有带 chat 的、还有中转站给的一串域名,不知道哪个填进 base_url、哪个是完整地址。这篇不聊价格也不聊模型能力,只把 DeepSeek 官方接口的地址结构、常见路径分别干什么活讲清楚,顺带给你一个换地址时的排查顺序,填错能自己看出来。
很多人拿到 Key 之后第一件事就是找「填哪个网址」,结果在文档里翻到好几个长得很像的地址:有带版本的、有带 chat 的、还有中转站给的一串域名,不知道哪个填进 base_url、哪个是完整地址。这篇不聊价格也不聊模型能力,只把 DeepSeek 官方接口的地址结构、常见路径分别干什么活讲清楚。
读完你应该能做到三件事:分清根地址和完整路径、照着路径对照表把请求拼对、换中转时知道先改哪一处再验证哪一处。下面每一节都给判断标准,遇到填完报 404 或一半成功一半失败的情况,能自己顺出来是地址问题还是网络问题。
先分清两种「URL」:根地址和完整路径
DeepSeek 相关的地址其实只有两层:一层是根地址,很多人叫 base_url,只到域名加版本段,不带具体功能名;另一层是完整请求地址,就是在根地址后面再拼一段路径,带上 chat、completions 这类字样。SDK 和客户端里填的是前者,curl 里写的是后者。分清这两层,后面九成的填错都能自己看出来。
| 你看到的东西 | 典型长相(示意结构) | 该填在哪 | 填错会怎样 |
|---|---|---|---|
| 根地址 / base_url | 域名 + 版本段结尾 | SDK、客户端的「基础地址」栏 | 填了完整地址,程序再接一次路径,拼出不存在的地址,报 404 |
| 完整请求地址 | 根地址 + 功能路径 | curl、HTTP 客户端、Postman 的请求行 | 把它当 base_url 填,等于把路径写了两遍 |
| 中转站给的地址 | 对方域名 + 版本段 | 直接整段替换 base_url | 只换一半,一半请求成功一半失败 |
判断方法很简单:填的地方如果写着「基础地址」「Base URL」「接口地址」这类字样,就只填到版本段为止,后面的路径交给 SDK 拼;如果是在写 curl 或者手动发请求,那才需要把完整路径写全。拿不准的时候,看一眼示例代码里同一个字段是怎么写的,照抄格式通常不会错。
几个常见路径各干什么
路径虽然长得像,用途差别不小。写业务代码最常用的是对话补全类路径,传入消息列表拿回复,网页聊天、客服问答基本都走它;补全类路径只给一段前缀让模型往下续写,老代码里还能见到,新项目一般直接用对话补全代替。
- 对话补全类路径:传消息列表、拿回复,绝大多数应用场景走这一条
- 补全类路径:给一段前缀做续写,兼容旧代码用,新项目可以不选
- 模型列表类路径:不带参数问「现在能用哪些模型」,顺手可以验证 Key 有没有生效
- 余额或用量类路径:查这个 Key 还能用多少,适合写脚本做额度监控
- 具体有哪些接口、路径怎么拼,到 DeepSeek 官方价格与规格(/official-api/providers/deepseek) 核对当时的入口
写连通性测试最省事的办法是先打模型列表类路径:它请求体轻、不消耗生成额度、返回结构简单,出错信息也比主业务接口干净。如果这一步就报鉴权错误,说明 Key 或根地址有问题,不用再去翻对话补全那段的代码。
换地址:什么时候该改,改哪一处
只用官方接口的话,根地址保持官方那串就行,别手动拼路径,交给 SDK;走自建中转或第三方平台,把根地址整段换成对方给的地址,路径部分通常保持不动,这是最常见的接入方式。真正麻烦的是只改了一半:根地址换了,代码某个角落还写死着官方域名,结果一部分请求走新地址一部分走旧地址,表现像间歇性故障,很难查。
- 第一步 确认填的是根地址打开配置文件或环境变量,看这个字段是只到版本段,还是已经带上了 chat、completions 这类字样。带了就说明填错了位置。
- 第二步 打印最终完整地址在请求发出前把拼好的完整地址打出来看一眼,确认没有双斜杠、没有重复路径、域名是当前想用的那个。这一步比读代码快。
- 第三步 用轻量路径测连通拿模型列表类路径单独跑一次,别拿主业务代码试。通了再回到业务请求;不通就看报错是鉴权、超时还是地址不存在,三类的排查方向完全不同。
- 第四步 只改一处再复测确认要换中转,就把 base_url 整段替换,其余不动,改完重跑第三步。一次只动一个变量,出问题才知道是谁引起的。
什么情况下这套顺序不适用:如果代码里把地址写在多个地方,或者用了网关做二次转发,那排查重点要放在「哪一层在改写地址」上,而不是单看 base_url 字段。这种项目建议先把所有出现地址的位置列出来,再逐个确认来源。
填地址前对一遍这张清单
下面这些细节单独看都不大,凑一起就是「明明照着文档填的却连不上」的常见原因。填之前扫一遍,能省掉不少来回试的时间。
- 结尾斜杠
- 地址结尾带不带斜杠要跟 SDK 示例保持一致,多一个少一个都可能拼出双斜杠
- 协议
- 正式环境一律用 https,跟 http 混用经常表现为连接超时而不是明确报错
- 端口号
- 官方地址通常不用写;自建服务挂在非标准端口上就必须写全
- 区域或线路
- 同一平台不同区域的地址可能不同,选错不一定报错,可能只是慢或者提示无权限
- 环境变量
- 用环境变量传地址时注意有没有多余空格和引号,复制粘贴最容易带进来
如果地址和格式都对,请求还是慢或者偶尔失败,就别继续在地址上纠结了,先量一次实际网络延迟,把地址问题和网络问题分开看。到 接口测速(/tools/speed-test) 跑一遍,比自己 ping 半天更直接。
下一步地址填对只是第一步,真正影响长期使用的是所选平台的稳定程度和响应表现。要挑中转或者核对当前可用的接口入口,从站内的中转站可信度检测和官方资料页进去看当时的实测数字,比对着截图猜靠谱。→常见问题
DeepSeek 的 API 地址是不是固定的?网上抄来的一串能直接用吗
域名结构是长期稳定的,但不是一串字符串永远不变。别人文章里抄的地址可能包含已经调整过的路径段,直接粘进代码容易拼错。稳妥做法是只记根地址的写法规则,具体路径以你账号能看到的接口文档为准,自己去 /official-api/providers/deepseekDeepSeek 官方价格与规格 顺一遍入口再动手。
base_url 里到底要不要带版本段?
以 SDK 或文档示例为准。有的客户端要求 base_url 只到域名,版本段由它自己补;有的要求你把版本段一起写上。拿不准就看官方给的示例代码里那一行是怎么写的,照着抄一遍,别凭印象删改。改完用一次轻量请求验证,比反复改主逻辑省事。
地址填对了但一直连不上,该从哪查起?
按这个顺序:先看填的是根地址还是完整地址,八成错在这一步;再确认 http 与 https、有没有多余斜杠;然后确认当前网络能访问该域名,这一步可以用 /tools/speed-test接口测速 量一次;最后确认 Key 对应的账号状态正常。地址类问题通常在第一次请求就暴露,不会时好时坏。