中文 ▾
获取 API 密钥

getdeepseekapi.com指南

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 和密钥。
铁路开关将发光的轨道重定向到不同的服务器,说明切换 API Base 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 APIPOST 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 URLhttps://api.getdeepseekapi.com/v1
API 密钥、Token、Secret来自此服务的密钥
Model、Model name、Model IDuncensored

某些应用需要完整的聊天 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。这就是全部设置。

获取 API 密钥