👁 83 次阅读

gpt_academic 如何接入 DeepSeek V3 API？

来源：binary-husky/gpt_academic Issue #2105，创建于 2025-01-06，当前状态 open，评论 10 条。

现象描述

用户在 gpt_academic 中希望调用 DeepSeek V3 的 API 接口，但发现无法直接使用。该 issue 从 2025 年 1 月 6 日创建至今仍处于 open 状态，未有官方维护者合入修复。多位用户在后续回复中反映，即使按照社区给出的配置步骤操作，调用 DeepSeek API 依然失败。

背景原因

据 issue 讨论，gpt_academic 的模型接入集中在 config_private.py 配置文件及对应的桥接模块中。DeepSeek 系列模型实际上已纳入 gpt_academic 的架构支持范围，但需要在配置文件中手动启用——官方仓库的默认配置未将其暴露为可选模型，用户需要自行修改配置才能调用。 据 issue 讨论中 memset0（2025-01-24）的说明，DeepSeek 官方 API 实际提供的模型名称为 deepseek-chat、deepseek-coder、deepseek-reasoner 三个，其中调用 deepseek-chat 实际即为 DeepSeek V3 模型。API endpoint 中写 V1 是为了兼容 OpenAI 的 BaseUrl 格式（参见 DeepSeek 官方文档：https://api-docs.deepseek.com/zh-cn/）。 此外，gpt_academic 仓库中不存在独立的 bridge_deepseek.py 文件，与 DeepSeek 相关的桥接模块仅有 bridge_deepseekcoder.py，该文件处理的是 DeepSeek Coder 本地模型场景，而非 DeepSeek V3 的云端 API 调用。

排查或量化方法

接入失败时，可按以下顺序排查： 1. 确认使用的 gpt_academic 版本（据 issue 讨论，saber65535 在 v3.91 版本中成功配置过）。 2. 检查 config_private.py 中 AVAIL_LLM_MODELS 列表是否包含 deepseek-chat。 3. 检查 config_private.py 中 DeepSeek 的 API KEY 是否已正确填写。 4. 确认调用时模型名称使用的是 deepseek-chat 而非 deepseek-v3 或 deepseek-V3——后者在 DeepSeek API 中并不存在。 5. 如使用 deepseek-reasoner（即 R1 模型），确认该模型名称同样已加入 AVAIL_LLM_MODELS。

完整解决方案

据 issue 讨论中 zjsailor（2025-01-12）给出的配置步骤： 步骤一：修改 config_private.py，在 AVAIL_LLM_MODELS 列表中加入 deepseek-chat。

LLM_MODEL = "deepseek-chat"

AVAIL_LLM_MODELS = [
    "gpt-4-1106-preview",
    "qianfan",
    "spark",
    "deepseek-chat",
    "deepseek-coder",
    "sparkv2",
    "sparkv3",
    "sparkv3.5",
    "sparkv4",
    "qwen-turbo",
    "qwen-plus",
    "qwen-max",
    "gemini-1.5-flash",
    "gemini-1.5-pro",
    "chatglm3",
    # ... 其他已有模型
]

步骤二：在 config_private.py 中填入 DeepSeek API KEY。 在 AVAIL_LLM_MODELS 配置下方，找到注释 # 深度求索(DeepSeek) API KEY，默... 对应的字段，填入有效的 API 密钥即可。 步骤三：启动 gpt_academic，在模型选择下拉菜单中选择 deepseek-chat 进行对话。 如需调用 R1 推理模型，将 deepseek-reasoner 加入 AVAIL_LLM_MODELS 并选择该模型即可。

参数或对比表格

调用目标	API 模型名称	说明
DeepSeek V3（对话）	deepseek-chat	实际对应 V3 模型，API endpoint 写 V1 仅为兼容 OpenAI BaseUrl
DeepSeek Coder	deepseek-coder	代码专用模型，对应本地模型场景
DeepSeek R1（推理）	deepseek-reasoner	2025 年 1 月后新增的推理模型

不存在的模型名称（不可用于 API 调用）：deepseek-v3、deepseek-V3、deepseek-V1、deepseek-R1。这些名称不在 DeepSeek 官方 API 文档中，使用会导致连接失败。

常见错误排查

错误 1：在模型选择中填入 deepseek-v3 或 deepseek-V3 导致连接失败。 DeepSeek API 不识别这些名称。根据 DeepSeek 官方文档，可用的模型名称仅为 deepseek-chat、deepseek-coder、deepseek-reasoner。据 issue 讨论中 LiJieqin（2025-01-21）的反馈，填入 deepseek-V1 和 deepseek-V3 均无法连接，只有 deepseek-chat 可以连通。 错误 2：找不到 bridge_deepseek.py 文件。 该文件在 gpt_academic 仓库中并不存在。仓库中仅有 bridge_deepseekcoder.py，该文件用于 DeepSeek Coder 本地模型场景。DeepSeek V3 云端 API 的接入不需要额外的桥接文件，只需修改 config_private.py 即可完成。据 issue 讨论中 zjsailor 的说明，配置完成后即可使用。 错误 3：按配置步骤操作后仍然无法调用。 据 issue 讨论，RoadtoAGI（2025-01-11）和 lu-zaijiaoxia（2025-02-18）、Jouiy（2025-02-24）均反馈按上述步骤配置后 DeepSeek API 调用仍不可用。该问题尚未得到官方维护者的回应或修复。issue 中未给出统一的根因结论。 错误 4：使用 deepseek-chat 连接成功但不确定连接的是哪个模型。 据 memset0（2025-01-24）在 issue 中的说明，deepseek-chat 实际对应的就是 DeepSeek V3 模型。DeepSeek API 中 endpoint 路径包含 V1 是为兼容 OpenAI BaseUrl 格式而设，不影响实际调用的模型版本。 错误 5：混淆本地模型与云端 API 的配置方式。 bridge_deepseekcoder.py 在 issue 中被指出对应的是 DeepSeek Coder 本地模型场景；而 deepseek-chat 对应 DeepSeek 云端 API，只需填写 API KEY。两者在 config_private.py 中的配置字段和连接方式不同，不应混用。

实践建议

• 始终使用 DeepSeek 官方文档中的模型名称（deepseek-chat、deepseek-coder、deepseek-reasoner），不要使用版本号缩写如 V3、V1、R1 作为 API 模型标识。
• 配置完成后先发送一条简短消息验证连接是否正常，再投入正式使用。
• 该 issue 目前仍处于 open 状态，官方尚未合入正式修复。社区变通方案（手动修改 config_private.py）对部分用户有效，但仍有用户反馈配置后无法使用，问题根因尚未明确。建议持续跟踪该 issue 的后续更新，或直接向 DeepSeek 官方 API 文档确认接口规范。

FAQ

Q1：gpt_academic 是否原生支持 DeepSeek V3？ gpt_academic 的代码架构中已包含 DeepSeek 的调用逻辑，但默认配置未将 deepseek-chat 暴露到模型选择列表中。用户需要在 config_private.py 中手动将其加入 AVAIL_LLM_MODELS 并填写 API KEY 后方可使用。据 issue 讨论，该功能目前依赖社区自行配置，官方尚未合入正式支持。 Q2：deepseek-chat 调用的就是 V3 模型吗？ 是。据 issue 讨论中 memset0 的说明并参考 DeepSeek 官方 API 文档（https://api-docs.deepseek.com/zh-cn/），调用 deepseek-chat 实际即为 DeepSeek V3 模型。API endpoint 路径中的 V1 仅为兼容 OpenAI BaseUrl 格式，不代表模型版本。 Q3：DeepSeek R1 模型如何在 gpt_academic 中调用？ R1 模型在 DeepSeek API 中的名称为 deepseek-reasoner。将其加入 AVAIL_LLM_MODELS 列表中并在配置中填入有效的 API KEY 后即可选择调用。注意不要使用 deepseek-R1 作为模型名称，该名称在 API 中不存在。 Q4：按社区配置步骤操作后仍然无法使用怎么办？ 据 issue 讨论，有部分用户在正确填写 deepseek-chat 至 AVAIL_LLM_MODELS 并配置 API KEY 后仍无法连通。该 issue 当前状态为 open，官方维护者尚未给出回应或修复方案。issue 中未给出统一的根因结论。若问题持续存在，可在该 issue 下补充具体的报错信息与复现步骤，供后续对比。 Q5：issue #2105 目前是否已修复？ 截至该 issue 的最后更新记录（2025-02-24），状态仍为 open，未有官方维护者提交修复或确认已解决。社区给出的配置方案对部分用户有效（saber65535 在 v3.91 版本中成功使用），但后续仍有用户（RoadtoAGI、lu-zaijiaoxia、Jouiy）反馈按相同步骤操作后仍不可用。问题的根因与维护者决策尚未明确。