SupaNexus
开始使用
OpenAI 兼容 · DeepSeek Harness · 1M 上下文

DeepSeek API不必绑死官方入口

在 SupaNexus 运行 DeepSeek V4 Pro 与 V4 Flash：一个 Base URL、一把 Key、OpenAI 兼容。面向 Agent，含 DeepSeek Harness 自定义提供方。

领取 DeepSeek API KeyDeepSeek Harness 接入

为什么选 SupaNexus

你现有技术栈已经会说的 DeepSeek 接入点。

所有模型共用一个 Base URL

今天 DeepSeek，明天 Qwen 或 GLM —— 同一套鉴权、同一套 Chat Completions、同一套计量。

为 DeepSeek Harness 准备好

把 SupaNexus 加为自定义提供方。用 GET /v1/models 拉目录，Agent 运行时保持可移植。

零留存，企业级计量

提示词不用于训练留存。用量、配额与消费上限都在同一个控制台。

目录

SupaNexus 上的 DeepSeek 型号

在 Chat Completions、DeepSeek Harness 以及任何 OpenAI 兼容客户端中使用 Public API ID。

型号Public API ID上下文适用
DeepSeek V4 Prodeepseek/deepseek-v4-pro1M
推理Agent旗舰
DeepSeek V4 Flashdeepseek/deepseek-v4-flash1M
对话Thinking高性价比

实时输入 / 缓存 / 输出单价在控制台查看。也可参考 首页定价 · 控制台型号目录

快速开始

30 秒完成第一次 DeepSeek 调用

即插即用 OpenAI SDK。改 Base URL 与 API Key，model 填 Public API ID。

https://api.supanexus.ai/v1

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.supanexus.ai/v1",
    api_key="sk-snx-...",
)

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

DeepSeek Harness

如何使用 DeepSeek Harness 自定义 API

DeepSeek Harness 是开源 Agent 运行时。SupaNexus 不在自带提供方目录里 —— 把它加为自定义提供方，用一把 Key 调用 V4 Pro / V4 Flash。

  1. 01

    安装 DeepSeek Harness

    按官方开发者预览文档 deepseek.com/harness 安装。产品迭代很快，请钉住你已验证过的版本。

  2. 02

    打开 设置 → 模型

    选择「添加自定义提供方」。自带卡片（DeepSeek 官方、OpenAI、Anthropic）不会指向 SupaNexus。

  3. 03

    设置永久 Provider ID

    使用小写 id，例如 supanexus。该 id 会写进会话与凭据引用 —— 以后改名等于新建提供方。

  4. 04

    Base URL 与协议

    Base URL 填 https://api.supanexus.ai/v1（国内备份 https://api.supanexus.io/v1）。API 协议选 OpenAI Chat Completions（openai-completions）。

  5. 05

    凭据与型号

    粘贴 SupaNexus 项目 API Key。添加 deepseek/deepseek-v4-pro 与 deepseek/deepseek-v4-flash，或使用「获取可用模型」（GET /v1/models）。

  6. 06

    保存，必要时编辑 settings.yaml

    界面会写入提供方。表单未暴露的字段，打开 $DSH_HOME/settings.yaml 编辑后重启 Harness。

推荐的 settings.yaml 片段

把密钥放在环境变量里，不要写进 YAML 文件。

settings.yaml

llm-pi-ai:
  providers:
    supanexus:
      apiKeyEnv: SUPANEXUS_API_KEY
      api: openai-completions
      baseURL: https://api.supanexus.ai/v1
      models:
        - id: deepseek/deepseek-v4-pro
        - id: deepseek/deepseek-v4-flash

推荐 API

DeepSeek Harness 推荐 API（SupaNexus）

除非同一套 Agent 已经依赖 Anthropic Messages，否则使用以下配置。

协议

OpenAI Chat Completions（openai-completions）。这是 SupaNexus 原生接口，也是 Harness 自定义网关的预期协议。

型号

Harness / Agent 循环用 deepseek/deepseek-v4-pro（旗舰推理）。更看重延迟与成本时用 deepseek/deepseek-v4-flash。

为何不用官方 DeepSeek 卡片

自带 DeepSeek 提供方打的是 DeepSeek 自家 API。SupaNexus 让你跨厂商共用一把 Key、统一计量，且目录侧没有官方峰谷计价差。

可选备用协议

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

DeepSeek Harness（官方）GitHub: deepseek-ai/deepseek-harness完整 API 文档

常见问题

DeepSeek API 问题

团队实际如何在 SupaNexus 上接入 DeepSeek。

Agent 与高难推理用 deepseek/deepseek-v4-pro；更看重延迟与成本时用 deepseek/deepseek-v4-flash。不要再传过时的 deepseek-chat 别名。

是。把官方 OpenAI SDK 指向 https://api.supanexus.ai/v1，使用 SupaNexus 项目 Key。流式、工具调用与 JSON mode 遵循 Chat Completions 约定。

可以。添加名为 supanexus 的自定义提供方，协议选 OpenAI Chat Completions，填入项目 Key。本页与 API 文档有完整步骤。

Global 使用 api.supanexus.ai。国内备份主机为 api.supanexus.io。同一套 API、同一套模型 ID。

其他热门模型 API

今天下午就把 DeepSeek Agent 跑起来。

创建项目、复制 Key，把 DeepSeek Harness 或任意 OpenAI SDK 指向 SupaNexus。

领取 DeepSeek API KeyDeepSeek Harness 接入