deepseek-v4接入教程

逛逛Github

841人浏览 · 2026-05-12 14:41:44

逛逛Github · 2026-05-12 14:41:44 发布

OpenOcta 接入 DeepSeek-V4 教程

本教程面向新手，每一步都附带说明，跟着操作即可配置成功。

适用版本：DeepSeek-V4（2026-04-24 正式发布）

接入 DeepSeek-V4 只需要三步：

拿 Key：去 DeepSeek 开放平台创建 API Key
配置：在 模型 的 DeepSeek 里配置 DEEPSEEK_API_KEY，在 agents 里指定模型为 deepseek/deepseek-v4-pro
验证：启动 OpenOcta 发一条消息测试

一、前置说明：DeepSeek-V4 模型版本

DeepSeek 官方 API 目前提供 V4 系列模型，旧版模型名即将弃用：

建议：新接入请直接使用 deepseek-v4-pro 或 deepseek-v4-flash，旧模型名将在三个月后停止服务。

二、获取 DeepSeek API Key

打开 DeepSeek 开放平台
登录账号（没有就注册一个，新注册账户需要实名）
进入左侧菜单「API Keys」
点击「创建 API Key」，给它起个名字（如 openocta）
立即复制生成的 Key（格式类似 sk-xxxxxxxxxxxxxxxx），它只会显示一次

保存好这个 Key，下一步会用到。

三、配置 OpenOcta json 文件

1、选择deepseek模型

2、填入配置

输入API Key

3、添加模型

输入对应版本模型ID

4、设为默认模型，并选择对应模型

5、json 配置（可选）

OpenOcta 的配置文件路径如下：

Windows: C:\Users\你的用户名\.openocta\openocta.json
macOS/Linux: ~/.openocta/openocta.json

四、进阶配置：自定义模型参数与思考强度

如果你需要显式声明模型参数（如上下文长度、思考强度、Base URL 等），请在 模型-DeepSeek 中配置：

五、验证配置是否成功

方法一：启动后看日志

在 OpenOcta 的 Web UI 中打开任意对话，选择对应模型
发送一条消息，如 "你好"
如果能正常收到 DeepSeek 的回复，说明配置成功

方法二：通过命令行快速验证（适合开发者）

如果你本地有 curl，可以直接测试 DeepSeek API 是否通：

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的Key" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "你好"}]
  }'

能返回 JSON 且包含 choices 字段，说明 Key 和模型都有效。

六、常见问题排查

1. 报错 "API key for provider deepseek not found"

原因：DEEPSEEK_API_KEY 没有正确设置。

解决：

检查 openocta.json 中 env.vars.DEEPSEEK_API_KEY 的值是否正确
确认没有多余的空格或换行
如果使用了 models.providers + $DEEPSEEK_API_KEY，确保 env.vars 里确实定义了该变量

2. 报错 "no model specified for provider deepseek"

原因：模型引用格式写错了。

解决：确保写的是 deepseek-v4-pro，而不是只写 deepseek。

3. 旧模型名弃用警告

现象：配置中使用了 deepseek-chat 或 deepseek-reasoner，收到弃用提示。

解决：在 2026-07-24 之前，旧模型名仍可正常使用（分别映射到 deepseek-v4-flash 的非思考模式和思考模式）。建议尽快迁移到新模型名 deepseek-v4-pro / deepseek-v4-flash。

4. 想切换回 Claude / GPT 等其他模型

直接修改 agents.defaults.model.primary 和 agents.list[].model 为对应模型引用即可，例如：

"model": "anthropic/claude-sonnet-4-6"

不需要删除 env.vars.DEEPSEEK_API_KEY，多个 Key 可以共存。

5. 使用第三方中转平台（如 OpenRouter）

如果你从 OpenRouter 等第三方平台获取的 Key，推荐将该平台作为独立 provider 配置：

{
  "env": {
    "vars": {
      "OPENROUTER_API_KEY": "sk-or-..."
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "openrouter/deepseek/deepseek-v4-pro" }
    },
    "list": [
      {
        "id": "main",
        "default": true,
        "name": "DeepSeek-V4",
        "model": "openrouter/deepseek/deepseek-v4-pro"
      }
    ]
  }
}

OpenRouter 的模型引用格式为 openrouter/<厂商>/<模型名>。