SupaNexus
开始使用

DeepSeek Harness — Markdown 源文

以下为可直接复制或提供给 AI Agent 的 Markdown 原文。

> **AI Agents**: 索引 `/api/llms.txt` | 英文全文 `/api/llms-full-en.txt` | 中文全文 `/api/llms-full-zh.txt` | OpenAPI `/api/openapi.yaml`
> Base URL: `<BASE_URL>/v1`

# DeepSeek Harness

将 [DeepSeek Harness](https://deepseek.com/harness/zh/) 添加为 **SupaNexus 自定义提供方**。自带的 DeepSeek 卡片会直连 DeepSeek 官方 API；要走本页接入点，请添加自定义提供方。同一把 Key 可调用 [模型](./models.md) 目录中的任意型号，不限于 DeepSeek。

DeepSeek 型号与定价见 [DeepSeek](/deepseek)。

> `<BASE_URL>` 取值见 [接入点](./endpoints.md)。官方 Harness：[deepseek.com/harness](https://deepseek.com/harness/zh/) · [GitHub](https://github.com/deepseek-ai/deepseek-harness)。

## 如何使用 DeepSeek Harness 自定义 API

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

```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` 列表可换成 [模型](./models.md) 中的任意 Public API ID。

## DeepSeek Harness 推荐 API

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

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

若其余工具已经走 Anthropic，可以把 Harness 指到 [Messages](./messages.md)（`POST /v1/messages`）。全新 Harness 接入请继续用 Chat Completions。

## OpenAI SDK（同一套型号）

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

```python
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 集成](./openai-sdk-integration.md) 与 [模型](./models.md)。