DeepSeek API 网址与 Base URL:如何切换
你从 DeepSeek 官方文档复制的 deepseek api url 是一个 Base URL,它仅适用于 DeepSeek 的密钥和 DeepSeek 的模型。如果你想要不同的 OpenAI 风格端点,请更改该 URL、密钥和模型 ID。
更新于
要点
- Base URL 是前缀;SDK 会在其后添加 /chat/completions。
- 此服务使用 https://api.getdeepseekapi.com/v1,模型 ID 为 uncensored。
- 这不是 DeepSeek 的 API,因此 DeepSeek 的密钥在此无法使用,反之亦然。
- 大多数客户端也接受通过 OPENAI_BASE_URL 和 OPENAI_API_KEY 传入的 URL 和密钥。

Base URL、接口和路径:三个部分
人们常将完整地址粘贴到期望前缀的字段中,从而导致 404 错误。以下三个术语可帮助你理清关系。
- Base URL: 每次调用的共享前缀,例如
https://api.getdeepseekapi.com/v1。这是你在客户端的“API base”或“Base URL”设置中填入的内容。 - 接口路径: 由 SDK 添加的部分,例如
/chat/completions、/responses或/models。 - 完整 URL: Base URL 加上路径,例如
https://api.getdeepseekapi.com/v1/chat/completions。curl 等原始 HTTP 客户端需要此 URL。
最常见的规则:SDK 和应用程序要求提供 Base URL,而 curl 和 HTTP 节点要求提供完整 URL。如果工具返回 404,首先检查是否将完整 URL 放入了期望 Base URL 的位置,或者反之。错误中的重复路径(如 /v1/chat/completions/chat/completions)是明显的迹象。
DeepSeek Base URL 是什么,以及不是什么
DeepSeek 在其文档中发布了其 API 地址,以及其密钥可用的模型名称。请查阅文档以获取当前值,不要轻信博客文章,包括本文。DeepSeek 密钥仅适用于 DeepSeek 的接口,不适用于其他任何地方。
本站的服务是一个独立产品。它不是官方的 DeepSeek API,不转发至 DeepSeek,也不提供 DeepSeek 模型。它是一个由独立提供商托管、针对合法成人用户无内容拒绝回答而优化的 OpenAI 兼容 API,用于单一开放权重模型。其地址为:
https://api.getdeepseekapi.com/v1 # model: uncensored
模型 ID 为 uncensored,认证方式为 Authorization: Bearer <key>。密钥在 API 密钥页面 发放。如果你正在比较密钥在每个服务中的含义,DeepSeek API 密钥 页面有更多详细信息。
在 OpenAI SDK 中切换接口
一旦你更改了 Base URL 和密钥,任何 OpenAI SDK 均可工作。在 Python 中:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getdeepseekapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
)
print(resp.choices[0].message.content)
在 Node.js 中,字段名为 baseURL:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.getdeepseekapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);
注意区别:Python 使用 base_url,Node 使用 baseURL。如果混淆,会静默回退到默认的 OpenAI 地址,从而导致服务端拒绝你的密钥。
无需修改代码的切换方式
官方 OpenAI SDK 读取两个环境变量,因此现有应用无需更改代码即可重新指向:
export OPENAI_BASE_URL="https://api.getdeepseekapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py # the app still has to request model "uncensored"
模型名称是你不能跳过的部分。如果应用硬编码了其他模型 ID,它将请求该模型并失败,因此请在应用的设置或配置中将其更改为 uncensored。许多工具在一个设置界面中提供这三个值,通常标记为 API base、API key 和 model。
相同的三值替换也适用于框架。例如,在 Python 中使用 LangChain,ChatOpenAI(base_url="https://api.getdeepseekapi.com/v1", api_key="YOUR_KEY", model="uncensored") 就足够了。接受 OpenAI 兼容接口的编码工具以相同方式工作;参见 使用 API 进行编码 的分步指南。
原始 HTTP:确切的路径
对于 curl、脚本和 HTTP 节点,你需要自行构建完整 URL。以下是此服务的路径:
| 用途 | 方法和 URL |
|---|---|
| 聊天 | POST https://api.getdeepseekapi.com/v1/chat/completions |
| Responses API | POST https://api.getdeepseekapi.com/v1/responses |
| 模型列表 | GET https://api.getdeepseekapi.com/v1/models |
| 余额 | GET https://api.getdeepseekapi.com/v1/balance |
| OpenAI 风格的余额 | GET https://api.getdeepseekapi.com/v1/dashboard/billing/credit_grants |
curl https://api.getdeepseekapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
仅使用 HTTPS。流式输出通过服务器发送的事件(SSE)使用 "stream": true 实现,同一 URL 同时支持两种模式。
在具有设置界面的应用中输入 URL
许多聊天前端、编辑器和自动化工具都提供“自定义 OpenAI 兼容接口”选项。标签不同,但字段一一对应:
| 应用中的字段 | 说明 |
|---|---|
| API base、Base URL、Endpoint、Server URL | https://api.getdeepseekapi.com/v1 |
| API 密钥、Token、Secret | 来自此服务的密钥 |
| Model、Model name、Model ID | uncensored |
某些应用需要完整的聊天 URL 而不是 Base URL。在这种情况下,使用 https://api.getdeepseekapi.com/v1/chat/completions。如果应用有“测试连接”按钮,它通常会调用模型列表,即 GET /v1/models。如果按钮失败但手动聊天正常,说明应用的检查比 API 更严格,你可以忽略它。
对 URL 的快速健全性测试
在调试应用之前,先用模型列表验证 URL。它不需要请求体,也不产生费用:
curl -s https://api.getdeepseekapi.com/v1/models -H "Authorization: Bearer $API_KEY" # the chat model ID is uncensored
你应该收到包含 data 数组的 JSON。如果返回 HTML 错误页面,说明主机或路径有误,例如缺少子域名:主机应以 api. 开头,而不是 www.。
修复常见错误
- 404 Not Found。 基础 URL 缺少
/v1,重复了两次,或者包含了接口路径。 - 401 或认证错误。 你使用了来自其他服务的密钥,或者请求头中缺少
Bearer。不同提供商之间的密钥不可互换。 - 未找到模型。 请求中仍然指定了旧提供商的模型。请设置为
uncensored。 - 应用仍在与旧服务通信。 某些工具会缓存设置或读取不同的变量。重启进程并检查设置界面。
- 尾部斜杠问题。 大多数客户端可以处理,但如果某个客户端不行,请从基础 URL 中删除末尾的斜杠。
如果你不确定是哪一侧出错,请发送上述 curl 命令。200 响应证明 URL、密钥和模型均正确;其余任何故障都出在你的应用中。文档 列出了限制和标头(如 X-Request-Id),这有助于你在联系支持团队时提供信息。
切换后保持不变的内容
请求和响应的结构遵循 OpenAI 格式,因此消息数组、temperature、top_p、stop、seed、惩罚项、函数调用和 JSON 模式均能正常工作。上下文窗口为 100,000 token(包含提示词和补全),最大请求体为 8 MB。该服务仅支持文本:不支持图像、音频、嵌入或微调,因此基于这些功能构建的应用需要更换提供商。
计费也与旧提供商分开:从预付额度中,每 1M 输入 token 收费 $0.15,每 1M 输出 token 收费 $0.50,详见定价页面。新用户可领取 $0.50 的免费试用额度,在付费前验证切换是否有效。
更多指南
问答
DeepSeek API 的基础 URL 是什么?
DeepSeek 在其官方文档中发布了该 URL,请查阅以获取当前值。本站点的接口是位于 https://api.getdeepseekapi.com/v1. 的不同服务。
我可以在这个接口上使用 DeepSeek 密钥吗?
不可以。密钥按服务发放。请在密钥页面获取此 API 的密钥,并将模型设置为 uncensored。
基础 URL 应以 /v1 结尾吗?
对此服务而言是的:https://api.getdeepseekapi.com/v1. SDK 会在其后添加接口路径,因此不要自行添加 /chat/completions。
更改 URL 后为什么会出现 404?
通常是路径重复或缺少 /v1。请将你的基础 URL 与上述确切值进行对比。
只需填写一个表单,即可获取密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。