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 —— 统一网关需要添加自定义提供方。

营销落地页：[SupaNexus 上的 DeepSeek API](/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. 打开 **设置 → 模型**，选择 **添加自定义提供方**。目录卡片不会指向 SupaNexus。
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`，或使用 **获取可用模型**（调用 OpenAI 兼容的 `GET /v1/models`）。
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。

## DeepSeek Harness 推荐 API

| 项 | 推荐 |
|------|----------------|
| 协议 | OpenAI Chat Completions（`openai-completions`）—— SupaNexus 原生接口 |
| 旗舰 / Agent | `deepseek/deepseek-v4-pro` |
| 延迟 / 成本 | `deepseek/deepseek-v4-flash` |
| Global 主机 | `https://api.supanexus.ai/v1` |
| 国内备份 | `https://api.supanexus.io/v1` |

只有在你确实要打 DeepSeek 自家 API 时，才用官方 DeepSeek 目录卡片。SupaNexus 让你跨厂商共用一把 Key、统一计量，且目录侧没有官方峰谷计价差。

若其余工具已经走 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)。