客户端接入/DeepSeek Harness

在 DeepSeek Harness 中使用 Wokey API

准备好 Wokey API Key，把 DeepSeek Harness 的 Base URL 指向 Wokey，再用一条 curl 请求确认连通。

本页内容expand_more

准备 API Key 与 Base URLlink

所有客户端都用同一个 Wokey API Key 和同一个 Base URL。

创建 API Key

登录后在 API 页面创建平台 Key；同一账户下的 Key 共享余额。

创建 API Keykey

使用 Wokey Base URL

客户端的 Base URL 填网关域名，按下方配置决定是否追加 /v1。

配置客户端link

DeepSeek Harness（dsh）支持自定义网关，在 Wokey 上可以同时用 DeepSeek、GPT、GLM 和 Claude 模型。2026-10-18 在 dsh 0.2.1-rc.2 上实测：deepseek-flash（Chat Completions）和 claude-haiku-5-5（Messages）都跑完了“运行测试、定位 bug、改代码、复测”的多轮工具调用任务，分别用时约 24 秒和 16 秒，重复运行时输入缓存命中约 99%。

  1. 1

    安装 0.2.1 预发布版

    npm 上的 latest 仍是 0.2.0；DeepSeek 建议用 v0.2.1-rc.1 及以上搭配 V4.1-Flash-1017，所以用 @next 安装。

  2. 2

    设置 API Key 环境变量

    配置里只写 apiKeyEnv，Key 不会进配置文件。也可以在 Web 界面 Settings → Models 里保存 Key。

  3. 3

    写入 provider

    编辑 ~/.dsh/profiles/web/cordis.patch.yml（dsh headless 用 profiles/headless）。一个 provider 只能用一种协议：DeepSeek、GPT、GLM 等用 OpenAI Chat Completions，Base URL 带 /v1；Claude 用 Anthropic Messages，Base URL 不带 /v1。也可以在 Settings → Models → Add model provider → Custom model API 里填同样的值，Fetch available models 会读取 Wokey 的 /v1/models。

  4. 4

    保留已有配置

    这份覆盖会替换 llm-pi-ai 整个条目的配置；如果已经在界面里加过其他 provider，把它们一起写进 providers。改完不用重启，下一个请求就生效。

DeepSeek Harness
# 1. 安装或升级到 0.2.1
npm install -g @deepseek-ai/dsh@next
export WOKEY_API_KEY="YOUR_API_KEY"

# 2. ~/.dsh/profiles/web/cordis.patch.yml
- id: llm-pi-ai
  config:
    providers:
      wokey:
        displayName: Wokey
        apiKeyEnv: WOKEY_API_KEY
        api: openai-completions
        baseURL: https://api.wokey.ai/v1
        compat:
          thinkingFormat: deepseek
        models:
          - id: deepseek-flash
            name: DeepSeek-V4.1-Flash
            contextWindow: 1000000
            maxTokens: 393216
            input: [text, image]
      wokey-claude:
        displayName: Wokey (Claude)
        apiKeyEnv: WOKEY_API_KEY
        api: anthropic-messages
        baseURL: https://api.wokey.ai
        models:
          - id: claude-haiku-5-5
            name: Claude Haiku 5.5
            contextWindow: 1000000
            maxTokens: 128000
            input: [text, image]
- id: agent-default-model
  config:
    provider: wokey
    model: deepseek-flash

# 3. 启动
dsh web

用 curl 验证link

客户端报错时，先用 curl 排除 Key 和 Base URL 的问题。

DeepSeek Harness 默认使用 OpenAI Chat Completions 协议。这条请求返回 200，说明 Key 和 Base URL 都正确；发送前把 YOUR_API_KEY 换成你的 Key。

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

错误与排障link

先区分认证、额度、限流、模型不可用和上游超时。

401

invalid api key

Key 缺失、写错、已删除，或 Authorization / x-api-key 认证 Header 冲突。

402

insufficient balance

账户额度不足，需要充值后继续请求。

429

rate limited

请求过于频繁，稍后重试或降低并发。

502

upstream unavailable

上游模型服务暂不可用，通常可以切换模型或稍后重试。

504

upstream timeout

上游响应超时，建议缩短上下文、降低 max_tokens 或重试。

529

upstream overloaded

上游模型暂时过载，Wokey 已先换线路重试过（code 为 upstream_unavailable），和你的余额无关。稍后重试或切换模型。