一个为所有人的API使用指南
返回官网 ↗
使用指南工具接入教程

DeepSeek Harness 接入教程

已经装好 DeepSeek Harness?跟着截图配好 API,选择模型和思考强度,收到第一条回复,再试一次工具调用。

跟着截图,一步一步配置

截图是中文界面。连接名称和地址使用教学示例标注,密钥已遮蔽。My API 表示「我的 API」,可以自行命名;图里的 API Base URL 只是占位文字,必须换成平台提供的真实地址。

01打开设置

  1. 点左下角「设置」

    如果左侧栏收起来了,先点左上角展开。

打开设置
中文界面 · 点击截图查看大图

02添加自定义提供方

  1. 打开「模型」

    在设置左侧点击「模型」。

  2. 添加提供方

    点击右侧下方的「添加自定义提供方」。

添加自定义提供方
中文界面 · 点击截图查看大图

03填好连接信息

  1. 名称

    Provider ID 可以填 my-api,显示名称可以填 My API。它们只是方便你识别这条连接,可以自己起名,不必与平台品牌相同。

  2. API 地址

    粘贴平台当前提供的完整 API 地址。不要用官网首页地址代替,也不要照抄截图里的占位文字。

  3. API 协议

    选择 OpenAI Chat Completions,在这个版本中显示为 openai-completions。

  4. API 密钥

    粘贴从平台获得的完整密钥,注意前后不要多出空格。

  5. 获取可用模型

    填好上面四项后,点「获取可用模型」。先让软件读取列表,再挑选模型。

填好连接信息
中文界面 · 点击截图查看大图

04勾选模型,点「添加所选」

  1. 查看返回的模型列表

    本次实际获取到了 deepseek-v4.1-flash-1017 和 glm-5.2;你当时能看到的模型可能不同。

  2. 本例选择 DeepSeek

    默认可能全部勾选。本例只保留 DeepSeek,取消勾选 glm-5.2。

  3. 点「添加所选」

    选中的模型会回到配置表单。本机这个按钮实际叫「添加所选」。

勾选模型,点「添加所选」
中文界面 · 点击截图查看大图

05创建并保存提供方

  1. 确认模型已加入

    下方应该出现你刚选择的 DeepSeek 模型。

  2. 点「创建提供方」

    点击表单最下方的「创建提供方」,等列表里出现你起的名称 My API,再继续。

创建并保存提供方
中文界面 · 点击截图查看大图

06给模型开启思考档位

  1. 打开配置文件

    本机这一版没有图形化推理等级开关。点击设置右上角「打开配置文件」,用文本编辑器打开 settings.yaml。

  2. 找到刚添加的模型

    在 My API 对应的提供方下找到 deepseek-v4.1-flash-1017,补充下面的 reasoningEfforts。不要改到其他提供方里的同名模型。

  3. 保存后查看菜单

    保存,再重新打开模型菜单。如果没有更新,重启 Harness 后再看。若你的版本已有「模型选项 → 推理等级」设置,可在该处配置。

给模型开启思考档位
中文界面 · 点击截图查看大图

只在刚添加的模型项内补充 reasoningEfforts;保留已有的地址、密钥引用和其他设置。下面是局部示意,不要拿它覆盖整份配置文件。

models:
  - id: deepseek-v4.1-flash-1017
    reasoningEfforts:
      low: low
      high: high
      max: max

开头的空格有意义,请用空格缩进。low、high、max 的拼写保持原样。

07选择一个工作区

  1. 先选工作区

    输入框提示「选择工作区」时,点「添加工作区」,选一个你允许它操作的文件夹。练习时可以先建一个空文件夹。

  2. 确认文件夹名称

    图中用的是 harness-api-practice,你可以起其他名字。看到文件夹名称后,再继续。

选择一个工作区
中文界面 · 点击截图查看大图

08在 My API 分组下选模型

  1. 打开模型菜单

    点击输入框右下角的当前模型名称,再打开「模型」列表。

  2. 选择刚配置的模型

    找到 My API 分组,点击 deepseek-v4.1-flash-1017。模型也可能显示为你自定义的 DeepSeek Flash。

在 My API 分组下选模型
中文界面 · 点击截图查看大图

09选择思考强度

  1. 再次打开模型菜单

    选好 My API 下的模型后,再点右下角模型名称,打开「推理等级」。

  2. 选择 Low、High 或 Max

    日常任务可以先选 High,复杂任务再尝试 Max,比较自己任务中的效果和用量。

  3. 确认档位已显示

    选择 High 后,输入框旁会显示 High。图中的 DeepSeek Flash 是同一模型的显示名称。

选择思考强度
中文界面 · 点击截图查看大图
实际点选 High 后,模型名称旁会显示档位。

实际点选 High 后,模型名称旁会显示档位。

开启菜单和上游实际处理档位是两件事。已测试的 Off、Low、High、Max 请求均被接受;Off 样本没有返回思考用量。更高档位可能增加耗时和用量,不保证每次答案都更好。

10发出第一条消息

  1. 确认模型

    右下角应是 My API 分组下的 DeepSeek 模型。

  2. 发送下面的测试话

    复制下方文字,点发送箭头。发送会产生实际模型用量,等回复出现。

发出第一条消息
中文界面 · 点击截图查看大图
请只回复四个字:连接成功。不要使用任何工具,也不要执行其他任务。

11收到回复,接入成功

  1. 查看回复

    实测截图中收到了「连接成功。」。看到对应的文字回复,说明这次普通对话已经接通。

  2. 查看用量

    回平台官网打开「消费记录」,可以查看本次模型使用情况。接着试下面的文件读取任务。

收到回复,接入成功
中文界面 · 点击截图查看大图