目标
让 DeepSeek Harness 用户使用自己的基础 URL 和 API 密钥,通过 RunAPI 转发聊天请求,无需原生供应商插件。
Claude 访客:新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次,仅用于 API 用量。
在 dsh 中将 RunAPI 添加为 Custom model API,通过 OpenAI Chat Completions 连接 https://runapi.ai/v1,即可在网页界面或无界面运行模式下与 gpt-5.4-nano 对话。
- 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
让 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 的 shell 中设置 RUNAPI_API_KEY。补丁从环境变量中读取密钥,因此密钥不会写入文件。
export RUNAPI_API_KEY="runapi_xxx"
保存 runapi.patch.yml 供 --patch 使用,或在 Settings → Models → Add model provider → Custom model API 中添加配置。界面保存独立配置,API 密钥存入凭据存储;--patch 会让 Settings 中的这些字段只读。
api: openai-completions
使用补丁运行一次无界面任务,或打开网页界面。界面用户聊天前先在模型选择器中选择 runapi/gpt-5.4-nano。终端或聊天中出现回复,表示 dsh 已连接到 RunAPI。
npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
| 字段 | 值 | 用途 |
|---|---|---|
| 供应商 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 目录中的低成本同步文本模型。 |
此同步请求使用与补丁相同的基础 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."}]}'
启动 dsh 的 shell 中未设置 RUNAPI_API_KEY。请导出该变量,或在 Models 页面保存密钥,然后重新运行同一条命令。
通常是。基础 URL 必须严格为 https://runapi.ai/v1;dsh 会自行追加 /chat/completions。连接错误则表示根本无法连接到主机。
请对照 RunAPI 模型目录核实模型 ID,例如 gpt-5.4-nano,并确认 agent-default-model 使用匹配的供应商 runapi 和模型 ID。
不需要。dsh 内置支持 OpenAI Chat Completions 的 Custom model API,而 RunAPI 提供该协议,因此文本对话只需此补丁即可。