GeiliAPI 接入手册

DeepSeek Harness

把 DeepSeek Harness 接到本站

本教程里说的 DeepSeek Harness，是 DeepSeek 的编程助手，不是网页聊天。走 OpenAI 兼容的 /v1/chat/completions，不要用 Codex 的 Responses 配法。内置 DeepSeek 官方卡片只会打到官方站，必须添加自定义网关。

开始前

先创建「国模综合」或你可见的国模分组密钥，对照 模型价格。Base URL 填 https://sub.geiliapi.com/v1，不要漏 /v1，也不要写成完整 /chat/completions 路径。

安装

按 DeepSeek Harness 官方 README 安装。常见方式：

Terminal
npm install -g @deepseek-ai/dsh
dsh --version

也可以先用 npx @deepseek-ai/dsh web 打开 Web UI，再在界面里配模型。

在 Web UI 添加本站

  1. 1

    打开 Settings → Models

    选择 Add a custom provider，不要只用内置 DeepSeek 卡片。

  2. 2

    填写网关

    Provider ID 用小写，例如 geili。Display name 填 GeiliAPI。Base URL 填 https://sub.geiliapi.com/v1。API protocol 选 openai-completions。API key 填国模综合 Key。

  3. 3

    加入模型

    点 Fetch available models，或手动添加 deepseek-v4-flash 与 deepseek-v4-pro。保存后在模型选择器里启用。

手动写 settings.yaml

配置文件通常在 ~/.dsh/settings.yaml。密钥不要写进文件，只用环境变量名：

YAML
llm-pi-ai:
  providers:
    geili:
      displayName: GeiliAPI
      apiKeyEnv: GEILI_SUB2API_KEY
      api: openai-completions
      baseURL: https://sub.geiliapi.com/v1
      models:
        - id: deepseek-v4-flash
        - id: deepseek-v4-pro

启动前设置 GEILI_SUB2API_KEY。若网关拒绝 developer 角色或 max_completion_tokens，在该 provider 下补：

YAML
      compat:
        supportsDeveloperRole: false
        maxTokensField: max_tokens

默认 deepseek-v4-flash。质量不够再换 deepseek-v4-pro。同一把国模 Key 也可试 kimi-k3、glm-5.3、qwen3.8-max。旧会话会记住当时的模型，换模型请开新会话。

提示

一键配置工具不覆盖 DeepSeek Harness。密钥只放环境变量或 Web UI 凭据库，不要写进 settings.yaml。

验证第一次请求

  1. 1

    跑一句最小任务

    在模型选择器启用 deepseek-v4-flash，新开会话，发送 只回复 OK。

  2. 2

    核对使用记录

    到控制台「使用记录」确认出现国模分组 Key 和 deepseek-v4-flash，接口应是 Chat Completions 而不是 Responses。

这个工具的故障

请求打到官方 DeepSeek 或拉不到模型

必须添加自定义 provider，不要只用内置 DeepSeek 卡片。协议选 openai-completions，不要套 Codex 的 wire_api = responses。

网关拒绝 developer 角色或 max_completion_tokens

在该 provider 下补 compat.supportsDeveloperRole: false 与 compat.maxTokensField: max_tokens。字段以官方 README / providers 文档 为准。

404 或模型不存在

Base URL 必须是 https://sub.geiliapi.com/v1。模型 ID 必须存在于该国模分组，先到控制台「使用密钥」核对。

下一步：换模型看选模型页；地址填错时看地址怎么填。

选模型 地址怎么填
已复制