中文 ▾
获取 API 密钥

deepseek4api.com指南

DeepSeek API 文档指南与即插即用替代方案

大多数查阅 DeepSeek API 文档的人想要得到相同的五个答案:基础 URL、如何认证、使用哪个模型名称、哪些参数有效,以及一个有效调用的样子。本文涵盖这些内容,然后展示针对另一个可替换的 OpenAI 兼容接口的相同调用。

更新于

两个匹配的连接器插头通过发光的代码块连接,展示即插即用 API 替换
两个不同高度的硬币堆向小服务器输送,展示输入和输出 token 定价

要点

  • DeepSeek 记录了一种 OpenAI 风格的 API,因此通过更改 Base URL、密钥和模型名称,OpenAI SDK 即可使用。
  • 本网站不是 DeepSeek 的官方 API;它提供 ID 为 uncensored 的单一独立开放权重模型。
  • 相同的代码在两者上运行:只有三个值需要更改。
  • 此处的上下文窗口为 100,000 token,支持流式输出、工具调用和 JSON 模式。

DeepSeek API 文档回答的五个问题

当开发者搜索 DeepSeek API 文档时,他们通常试图完成首次请求。其模式与任何 OpenAI 风格的服务相同,这就是为什么表格可以轻松进行比较的原因。

问题DeepSeek 的文档此 API
Base URL在其快速入门中记录 (api.deepseek.com)https://api.deepseek4api.com/v1
认证Authorization 标头中的 Bearer tokenAuthorization 标头中的 Bearer token
模型名称列在其模型文档中;请检查当前名称uncensored
主接口聊天补全聊天补全、Responses、模型列表
定价查阅其当前定价$0.15 / 1M 输入 token,$0.50 / 1M 输出 token

有关其模型、价格和限制的任何信息,请阅读 DeepSeek 自己的页面;它们会发生变化,本文不试图重新陈述它们。重点是请求结构是共享的,因此在两者之间切换只需更改配置。

需要明确的一点是:本网站不是 DeepSeek 的官方 API,也不是到 DeepSeek 的路由器。它是一个托管的 OpenAI 兼容接口,由独立提供商提供,服务于一个开放权重模型,并针对合法成人用途无内容拒绝进行优化。

步骤 1:认证和 Base URL

创建账户(Google,或电子邮件和密码)并打开 API 密钥页面。复制密钥。新用户还可以一键领取 $0.50 的试用额度,有效期 7 天且无需信用卡。

每个请求都携带标头 Authorization: Bearer YOUR_KEY。使用 curl:

curl https://api.deepseek4api.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

这里列出了可用模型 uncensored。如果你复制 DeepSeek 的示例,需要替换三件事:基础 URL、密钥和模型名称。其他内容无需更改。

步骤 2:Python 中的聊天补全

OpenAI SDK 是 DeepSeek 文档示例中使用的,在此处无需更改即可使用:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepseek4api.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise technical assistant."},
        {"role": "user", "content": "Explain idempotency in two sentences."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

支持的采样参数,包括 temperature、top_p、stop、seed 以及存在和频率惩罚,都会透传。max_tokens 是可选的,因为补全可以使用 100,000 token 窗口中剩余的任何内容。

步骤 3:流式输出、JSON 模式和工具

流式输出

设置 stream: true 以接收服务器发送的事件。使用情况在流结束时报告。

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseek4api.com/v1",
  apiKey: process.env.API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about caching." }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

JSON 模式

传递 response_format: {"type": "json_object"} 并在提示词中提及 JSON。输出是一个你可以直接解析的 JSON 对象。

函数调用

tools 和 tool_choice 参数遵循 OpenAI 格式,工具调用以增量流式输出返回,你需要以 role: "tool" 角色返回消息。如果你的代码已针对 DeepSeek 实现函数调用,只需进行上述三项更改即可迁移,但请测试你自己的模式。

两者的差异之处

相同的协议并不意味着相同的服务。在迁移工作负载时需要注意的事项:

  • 模型行为。 不同的模型会给出不同的答案、推理风格和拒绝行为。在生产环境切换任何内容之前,请重新运行你的提示词集。
  • 特定于推理的字段。 如果你依赖于特定 DeepSeek 模型的供应商特定响应字段,不要假设它们在此处存在。标准的聊天补全字段是存在的。
  • 未提供的功能。 此接口仅支持文本:无图像、音频、视频、嵌入或微调。
  • 限制。 完整密钥允许 8 个并发请求和每分钟 300 个请求;试用密钥允许 2 个和 60 个。超过限制时,你会收到 HTTP 429 以及 rate_limited 或 concurrency。
  • 余额。 使用 GET /v1/balance、OpenAI 风格的信用授予路由或每个响应上的 X-Balance-USD 标头检查信用。

要了解专注于 DeepSeek 的用户如何考虑成本,请参阅 DeepSeek 定价说明;对于编辑器设置,请参阅 VS Code 指南。

此处的调用成本

计费为预付且按 token 计费:每 1M 输入 token 为 $0.15,每 1M 输出 token 为 $0.50。一次包含 1,500 个输入 token 和 600 个输出 token 的请求,输入费用为 1,500 x $0.15 / 1M = $0.000225,输出费用为 600 x $0.50 / 1M = $0.0003,总计 $0.000525。充值 $20 可覆盖约 38,000 次此类请求。

充值接受从 $20 到 $500 的任何整数金额,从 $50 起 +5%,从 $100 起 +10%,从 $200 起 +15%。你可以通过加密货币(TRC20 上的 USDT、Base 上的 USDC)支付。额度永不过期,失败或被拒绝的请求不收费。详见 定价页面。

迁移检查清单

如果你正在移植已经与 DeepSeek 通信的应用程序,请按顺序完成以下步骤。每个步骤只需几分钟。

  1. 将三个值放入配置。 Base URL、密钥和模型名称应来自环境变量,而不是散落在代码中的常量。
  2. 运行冒烟测试。 一次聊天补全、一次流式补全、一次 JSON 模式调用和一次工具调用。上面的四个代码片段涵盖了它们。
  3. 重放真实提示词。 从你的日志中获取 30 个提示词,并排比较答案。根据你的标准而非通用分数来评估它们。
  4. 处理 429。 添加带退避的重试并尊重 Retry-After。流式请求在其流结束之前会占用其并发槽位,因此请关闭放弃的流。
  5. 监控成本。 记录每个响应的 usage 并与一天流量中的 X-Balance-USD 标头进行比较。
  6. 逐步推出。 首先将 5 到 10% 的流量发送到新接口,然后增加。

比较每项任务的成本,而非每个 token 的价格,因为不同的模型完成同一任务所需的 token 数量不同。若要开放性地测试宽松型写作模型的行为,角色扮演介绍是一个有用的参考。

选择它们

当你特别需要 DeepSeek 模型、其厂商功能或其官方支持时,请使用 DeepSeek 自己的 API。当你想要一个托管的 OpenAI 兼容模型,该模型在合法成人使用中不进行内容拒绝,具有简单的预付费计费且提示词不用于训练时,请使用此接口。许多团队可能希望两者都通过配置开关实现,共享的协议使这变得容易。此 API 的参考资料位于 文档中。

问答

这是 DeepSeek 的官方 API 吗?

不是。这是一个独立的 OpenAI 兼容接口,提供 ID 为 uncensored 的单一开放权重模型。它不是 DeepSeek 的服务,也不路由到 DeepSeek。

我可以复用我的 DeepSeek 代码吗?

如果它使用 OpenAI SDK 或聊天补全格式,通常可以。更改基础 URL、密钥和模型名称,然后测试你的提示词。

我在哪里找到模型名称?

调用 GET /v1/models。该接口提供单个模型,其模型 ID 为 uncensored。

上下文窗口有多长?

100,000 个 token 用于提示词和补全。

Authorization 标头中的 Bearer token

创建账户,复制密钥,更改基础 URL。这就是全部设置。