Claude 访客:新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次,仅用于 API 用量。

DEEPSEEK HARNESS + RUNAPI

在 DeepSeek Harness 中使用 RunAPI。

在 dsh 中将 RunAPI 添加为 Custom model API,通过 OpenAI Chat Completions 连接 https://runapi.ai/v1,即可在网页界面或无界面运行模式下与 gpt-5.4-nano 对话。

已使用 dsh 0.2.1-rc.2 对本地桩服务进行检查 · 未发起上游付费调用
- id: llm-pi-ai
  config:
    providers:
      runapi:
        apiKeyEnv: RUNAPI_API_KEY
        api: openai-completions
        baseURL: https://runapi.ai/v1
        models:
          - id: gpt-5.4-nano
- id: agent-default-model
  config:
    provider: runapi
    model: gpt-5.4-nano
export RUNAPI_API_KEY="runapi_xxx"
npx @deepseek-ai/[email protected] --version
npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
npx @deepseek-ai/[email protected] web --patch runapi.patch.yml
已使用 dsh 0.2.1-rc.2 检查/v1
范围

一个模型,一次文本对话

目标

让 DeepSeek Harness 用户使用自己的基础 URL 和 API 密钥,通过 RunAPI 转发聊天请求,无需原生供应商插件。

最小可用配置

一个名为 runapi 的 Custom model API 供应商、一个 gpt-5.4-nano 模型,以及一条能收到回复的文本消息。

固定版本

配置和命令已使用 @deepseek-ai/dsh 0.2.1-rc.2 检查。在自行检查较新版本之前,请通过 npx 固定使用此版本。

无付费调用的检查范围

dsh 的加载、请求格式、回复和错误消息均通过 RunAPI 端点的本地桩服务进行了检查。本页面未向上游供应商发起任何付费请求。

配置

三步将 dsh 连接到 RunAPI

1

导出 RunAPI 密钥

在启动 dsh 的 shell 中设置 RUNAPI_API_KEY。补丁从环境变量中读取密钥,因此密钥不会写入文件。

export RUNAPI_API_KEY="runapi_xxx"
2

添加 Custom model API

保存 runapi.patch.yml 供 --patch 使用,或在 Settings → Models → Add model provider → Custom model API 中添加配置。界面保存独立配置,API 密钥存入凭据存储;--patch 会让 Settings 中的这些字段只读。

api: openai-completions
3

发送一条文本消息

使用补丁运行一次无界面任务,或打开网页界面。界面用户聊天前先在模型选择器中选择 runapi/gpt-5.4-nano。终端或聊天中出现回复,表示 dsh 已连接到 RunAPI。

npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
参考

Custom model API 字段

字段 值 用途
供应商 ID runapi 会话、默认设置和凭证引用使用的固定 ID。
基础 URL https://runapi.ai/v1 将请求发送到 RunAPI 的 OpenAI 兼容端点。
API 协议 openai-completions RunAPI 在 /v1/chat/completions 提供的 OpenAI Chat Completions 协议。
凭证 RUNAPI_API_KEY 通过 apiKeyEnv 从环境变量读取,或通过 Models 页面保存。
模型 gpt-5.4-nano RunAPI 目录中的低成本同步文本模型。
对话检查

使用 dsh 前先检查密钥和模型

此同步请求使用与补丁相同的基础 URL、密钥和模型,并将回复限制为 64 个 token。如果能返回消息,则 dsh 失败的原因在于 dsh 配置,而不是 RunAPI 账户。

curl https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.4-nano", "max_tokens": 64, "messages": [{"role": "user", "content": "Reply with one short sentence."}]}'
故障排查

DeepSeek Harness 错误

dsh 因 MISSING_CREDENTIAL 停止。缺少什么?

启动 dsh 的 shell 中未设置 RUNAPI_API_KEY。请导出该变量,或在 Models 页面保存密钥,然后重新运行同一条命令。

dsh 报告 404 或连接错误。基础 URL 是否有误?

通常是。基础 URL 必须严格为 https://runapi.ai/v1;dsh 会自行追加 /chat/completions。连接错误则表示根本无法连接到主机。

URL 正确,但 dsh 报告 404 Resource not found。应该检查什么?

请对照 RunAPI 模型目录核实模型 ID,例如 gpt-5.4-nano,并确认 agent-default-model 使用匹配的供应商 runapi 和模型 ID。

需要原生 RunAPI 供应商插件吗?

不需要。dsh 内置支持 OpenAI Chat Completions 的 Custom model API,而 RunAPI 提供该协议,因此文本对话只需此补丁即可。

获取用于 dsh 的 RunAPI 密钥。

创建或登录 RunAPI 账户,创建 API 密钥,并在启动 dsh 前将其导出为 RUNAPI_API_KEY。