Model and Modality Playbooks2026年6月22日Big Y

通过 OpenAI 兼容路由器访问 DeepSeek API

使用直接的 DeepSeek 密钥或 Flatkey 的 OpenAI 兼容路由器来配置 DeepSeek API 访问。对比 base URL、当前 V4 模型 ID、价格核查和迁移步骤。

如果你需要在一个已经使用 OpenAI 风格 SDK 的产品中接入 DeepSeek API access，最干净的迁移路径通常不是完全重写客户端，而是修改基础 URL、API 密钥和模型 ID 的选择。

DeepSeek 的官方 API 文档说明，该 API 使用的格式与 OpenAI 和 Anthropic 兼容。截至 2026 年 6 月 11 日，官方 quickstart 中当前的 DeepSeek 模型名称是 deepseek-v4-flash 和 deepseek-v4-pro。较旧的别名 deepseek-chat 和 deepseek-reasoner 仍有文档说明，但 DeepSeek 已将这两个名称标记为将在 2026 年 7 月 24 日 15:59 UTC 弃用。

这个模型名称的细节很重要。很多 DeepSeek API access 指南仍然展示旧别名，或者只关注直接的提供方密钥。本指南将展示如何评估直接的 DeepSeek 接入，以及如何通过像 Flatkey 这样的 OpenAI 兼容路由接入 DeepSeek，在同一应用模式下，你还可以同时使用 GPT、Claude、Gemini、Qwen、Seedance 和图像模型。

快速回答：直接 DeepSeek API 访问 vs 路由器访问

最佳的DeepSeek API 访问路径取决于你想拥有什么。

访问路径	适用场景	代码中会变更什么	需要检查什么
直接 DeepSeek API	你想要一个直接的 DeepSeek 账号、直接的 DeepSeek 定价，以及以 DeepSeek 原生文档作为事实来源。	将 OpenAI SDK 的 base URL 设置为 `https://api.deepseek.com`，并使用 DeepSeek API key。	DeepSeek 文档中的当前模型名称、弃用说明、定价、token 限制和速率限制。
Flatkey OpenAI-compatible router	你希望通过一个 API key 同时使用 DeepSeek 和其他模型家族，获得统一计费，以及用于 key、用量和路由的仪表板。	将 base URL 设置为 `https://router.flatkey.ai/v1`，使用 Flatkey key，并选择 Flatkey 列出的 DeepSeek 模型 ID。	Flatkey 模型目录可用性、模型 ID 拼写、定价页面，以及首次调用后的使用日志。
Self-hosted proxy	你需要运营自己的网关、策略层或私有路由基础设施。	你的应用指向你的代理端点，而你的平台团队将该代理连接到提供商账户。	部署、密钥、可观测性、事件响应以及提供商账户所有权。

如果你的团队只需要一个 DeepSeek 工作负载，并且希望建立直接的商业关系，那么直接的提供商配置会很简单。如果你的团队要把 DeepSeek 加入现有的多模型栈，基于路由器的DeepSeek API 访问可以减少账号分散，并让迁移尽量接近你已经在使用的 OpenAI-compatible 客户端模式。

需要先验证的 DeepSeek 当前事实

在你发布或部署 DeepSeek API 访问之前，请在当天确认模型名称。DeepSeek 的官方文档目前显示以下基准：

字段	当前官方详情
OpenAI 格式基础 URL	`https://api.deepseek.com`
Anthropic 格式基础 URL	`https://api.deepseek.com/anthropic`
当前模型 ID	`deepseek-v4-flash` 和 `deepseek-v4-pro`
已弃用别名	`deepseek-chat` 和 `deepseek-reasoner` 在文档中注明于 2026 年 7 月 24 日 15:59 UTC 后弃用。
上下文与输出	DeepSeek 的定价页面列出了当前 V4 模型的 1M 上下文长度和 384K 最大输出。
计价基础	DeepSeek 的定价页面列出了每 1M token 的价格，并建议查看页面了解当前定价。

这就是为什么现代 DeepSeek API 访问指南不应将 deepseek-chat 硬编码为默认模型。如果你今天使用该别名，请制定迁移计划，切换到 deepseek-v4-flash 或 deepseek-v4-pro。如果你使用路由器，请检查你的路由器目录是否暴露当前的 DeepSeek 模型 ID、较旧的兼容别名，或两者都提供。

使用 OpenAI SDK 直接访问 DeepSeek API

对于直接访问 DeepSeek API，如果你的应用已经在使用 OpenAI SDK，设置会很熟悉。你创建一个客户端，修改基础 URL，使用 DeepSeek API 密钥，并调用 DeepSeek 模型。

import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "deepseek-v4-pro",
  messages: [
    { role: "system", content: "You are a concise technical assistant." },
    { role: "user", content: "Summarize this migration plan." }
  ],
  stream: false
});

console.log(response.choices[0].message.content);

当 DeepSeek 账户本身就是需求的一部分时，请使用这条路径。直接访问 DeepSeek API会让 DeepSeek 的文档、定价、速率限制和支持路径成为主要的运行模式。

直接设置还可以让你在 DeepSeek 特定参数上几乎没有歧义。DeepSeek 目前的示例包含适用于 V4 模型的思考相关字段。如果这些参数对你的工作负载很重要，先直接在 DeepSeek 上测试，然后在通过网关投入生产前，确认你的路由器是否会透传相同字段。

通过 Flatkey 访问 DeepSeek API

当 DeepSeek API 访问 只是更大技术栈中的一个模型家族需求时，Flatkey 会很有用。Flatkey 的公开产品文案表示，开发者只需一个 API key，就能访问 Claude、GPT、Gemini、DeepSeek、Qwen、Seedance 2.0、GPT Image 等模型，而无需管理多个独立的供应商账户。它还描述了清晰的定价、统一计费、用于管理密钥、用量和路由的单一控制台，以及自动切换和负载均衡。

路由迁移模式刻意保持很小：

创建或使用一个 Flatkey API key。
将你的 OpenAI 兼容客户端指向 https://router.flatkey.ai/v1。
选择 Flatkey 定价页面或控制台中显示的一个 DeepSeek 模型 ID。
先运行一次非关键请求。
在控制台中确认响应、模型路由、用量记录和费用条目。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FLATKEY_API_KEY,
  baseURL: "https://router.flatkey.ai/v1"
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-pro", // 在部署前确认当前的 Flatkey 模型 ID。
  messages: [
    { role: "system", content: "You are a concise technical assistant." },
    { role: "user", content: "Draft a release note for this feature." }
  ]
});

console.log(response.choices[0].message.content);

在 2026 年 6 月 11 日，Flatkey 的公开定价端点返回了 653 行模型数据，其中包含 deepseek-v4-flash、deepseek-v4-pro、deepseek-v3.2、deepseek-v3.2-thinking、deepseek-chat 和 deepseek-reasoner 等 DeepSeek 条目。请将其视为带日期的目录快照，而不是永久保证。对于生产环境的 DeepSeek API 访问，在选择模型 ID 之前，请检查实时的 Flatkey 定价页面以及你账户中的模型选择器。

当路由器比直接密钥更有帮助时

路由器并不自动比直接的 DeepSeek API 访问 更好。只有当周边访问层才是难点时，它才更有优势。

基于路由器的 DeepSeek API 访问 适合以下情况：

你的应用已经在调用兼容 OpenAI 的聊天补全接口。
你希望在不为每个开发者增加另一套供应商账户流程的情况下接入 DeepSeek。
你正在同一产品功能上将 DeepSeek 与 GPT、Claude、Gemini 或 Qwen 进行对比。
你需要为团队提供一个统一的计费和用量审查界面。
在流量增长之前，你希望先建立配额使用习惯。
如果模型名称、供应商规则或价格发生变化，你希望有更平滑的迁移路径。

直接的 DeepSeek API 访问 更适合以下情况：

你需要直接的 DeepSeek 合同或供应商关系。
你正在测试 DeepSeek 特有的请求参数，而这些参数可能还无法通过路由器透传。
你的采购或数据政策要求直接遵循供应商条款。
你希望将一个仅使用 DeepSeek 的工作负载隔离出来，而不需要多模型路由能力。

现有 OpenAI 兼容应用的迁移清单

在将 DeepSeek API 访问纳入生产路径之前，请先使用此清单。

步骤	要做什么	重要原因
1	列出确切的工作负载：聊天、推理、JSON 输出、工具调用或代码辅助。	DeepSeek V4 的模型选择和思考模式应与工作负载匹配。
2	选择一个当前模型 ID，最好是在可用时使用 `deepseek-v4-flash` 或 `deepseek-v4-pro`。	旧别名在官方 DeepSeek 文档中有过时的弃用说明。
3	在非生产环境中更改基础 URL 和 API 密钥。	这可以确认迁移确实只是配置更改，而不是重写。
4	发送一个小型测试提示，并检查响应结构、令牌使用情况和错误。	OpenAI 兼容并不意味着可以免于验证模型行为。
5	根据访问路径，在 DeepSeek 或 Flatkey 中检查计费和使用日志。	成本可见性是访问决策的一部分，而不是事后补充。
6	针对一个上游错误、超时或配额条件测试回退行为。	路由用户需要知道当模型路由失败时会发生什么。
7	在配置中固定模型 ID，并在 2026 年 7 月 24 日之前安排一次模型名称审查。	这可以避免在 DeepSeek 公布的日期之后继续依赖已弃用的别名。

关于免费 DeepSeek API 访问

围绕这个主题的一些搜索会使用诸如 DeepSeek API key free access、DeepSeek R1 free API access 或 DeepSeek API free access limits 之类的术语。除非当前提供商或路由页面明确记录了该优惠，否则不要围绕这些说法制定生产方案。

DeepSeek 的官方定价页面是获取直接提供商定价的正确来源。Flatkey 的定价页面是获取 Flatkey 路由使用情况的正确来源。本文不声称有免费 DeepSeek API 访问额度，因为免费权益可能会迅速变化，且必须在你注册当天以来源为准进行核实。

常见问题

当前 DeepSeek API 的基础 URL 是什么？

对于直接的 OpenAI 格式 DeepSeek API 访问，DeepSeek 的官方文档列出了 https://api.deepseek.com。对于 Anthropic 格式访问，文档列出了 https://api.deepseek.com/anthropic。通过 Flatkey，OpenAI 兼容的路由器基础 URL 是 https://router.flatkey.ai/v1。

我现在应该使用哪个 DeepSeek 模型？

DeepSeek 当前官方快速入门列出了 deepseek-v4-flash 和 deepseek-v4-pro。文档说明 deepseek-chat 和 deepseek-reasoner 将于 2026 年 7 月 24 日 15:59 UTC 被弃用，因此新的 DeepSeek API 访问工作应避免将这些别名视为长期默认选项。

我可以使用 OpenAI SDK 访问 DeepSeek 吗？

可以。DeepSeek 的文档说明其 API 格式兼容 OpenAI 和 Anthropic。使用 OpenAI SDK 时，直接 DeepSeek 访问使用 DeepSeek 的基础 URL 和密钥。使用 Flatkey 时，基于路由器的 DeepSeek API 访问使用 Flatkey 的基础 URL 和密钥。