SupaNexus

DeepSeek Harness

Markdown 版本

示例中的 <BASE_URL> 请从 接入点 选择并替换。

DeepSeek Harness 添加为 SupaNexus 自定义提供方。自带的 DeepSeek 卡片会直连 DeepSeek 官方 API;要走本页接入点,请添加自定义提供方。同一把 Key 可调用 模型 目录中的任意型号,不限于 DeepSeek。

DeepSeek 型号与定价见 DeepSeek

<BASE_URL> 取值见 接入点。官方 Harness:deepseek.com/harness · GitHub

如何使用 DeepSeek Harness 自定义 API

  1. 按官方开发者预览安装 DeepSeek Harness。请钉住已验证的版本 —— 预览仍会有破坏性变更。
  2. 打开 设置 → 模型,选择 添加自定义提供方。官方 DeepSeek 卡片不会使用本页接入点。
  3. 设置小写 Provider ID,例如 supanexus。该 id 对会话与凭据是永久的。
  4. Base URL<BASE_URL>/v1API 协议:OpenAI Chat Completions(openai-completions)。
  5. 粘贴 SupaNexus 项目 API Key
  6. 添加型号,例如 deepseek/deepseek-v4-prodeepseek/deepseek-v4-flash;或使用 获取可用模型GET /v1/models)拉取全部可调用型号。Qwen、Kimi、GLM 等其它 Public API ID 同样可用。
  7. 保存。表单未暴露的字段,编辑 $DSH_HOME/settings.yaml 后重启。
llm-pi-ai:
  providers:
    supanexus:
      apiKeyEnv: SUPANEXUS_API_KEY
      api: openai-completions
      baseURL: "<BASE_URL>/v1"
      models:
        - id: deepseek/deepseek-v4-pro
        - id: deepseek/deepseek-v4-flash

把密钥放在 SUPANEXUS_API_KEY,不要写进 YAML。models 列表可换成 模型 中的任意 Public API ID。

DeepSeek Harness 推荐 API

推荐
协议OpenAI Chat Completions(openai-completions
旗舰 / Agentdeepseek/deepseek-v4-pro
延迟 / 成本deepseek/deepseek-v4-flash
默认接入点https://api.supanexus.ai/v1
备用接入点https://api.supanexus.io/v1

只有在你确实要直连 DeepSeek 官方 API 时,才使用官方 DeepSeek 目录卡片。

若其余工具已经走 Anthropic,可以把 Harness 指到 MessagesPOST /v1/messages)。全新 Harness 接入请继续用 Chat Completions。

OpenAI SDK(同一套型号)

Harness 之外也可以用同一套 Public API ID:

from openai import OpenAI

client = OpenAI(
    base_url="<BASE_URL>/v1",
    api_key="sk-snx-...",
)

response = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro",
    messages=[{"role": "user", "content": "你好!"}],
)
print(response.choices[0].message.content)

另见 OpenAI SDK 集成模型