客户端接入/WorkBuddy

在 WorkBuddy 中使用 Wokey API

准备好 Wokey API Key,把 WorkBuddy 的 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

WorkBuddy 通过 OpenAI Chat Completions 调用自定义模型。在 WorkBuddy 的设置 → 模型 → 自定义模型中,使用 Wokey 的接口地址、API Key 和 deepseek-flash;工具调用与图片输入可以直接用于 WorkBuddy 的任务和 Agent 工作流。

  1. 1

    打开模型设置

    点击 WorkBuddy 左下角账号 → 设置 → 模型;也可以在对话框的模型选择器底部点击「配置自定义模型」。

  2. 2

    添加自定义模型

    提供商选择「自定义 / Custom」。接口地址填 https://api.wokey.ai,API Key 填你的 Wokey API Key,模型名称精确填写 deepseek-flash,不要填显示名称 DeepSeek-V4.1-Flash。

  3. 3

    设置能力开关

    打开工具调用和图片输入,关闭思考模式与自定义协议。deepseek-flash 支持文本、图片和工具调用;如果改用 deepseek-v4-flash,必须关闭图片输入,因为它是文本模型。

  4. 4

    保存并切换模型

    点击测试连接后保存,在对话界面的模型选择器中选择自定义模型。先发送一条短文本,再测试工具调用或图片输入。

WorkBuddy
提供商:自定义 / Custom
接口地址:https://api.wokey.ai
API Key:YOUR_API_KEY
模型名称:deepseek-flash
工具调用:开启
图片输入:开启
思考模式:关闭
自定义协议:关闭

常见排障link

  • 404:保持接口地址为 https://api.wokey.ai,并关闭自定义协议;只有在开启自定义协议时才填写完整的 https://api.wokey.ai/v1/chat/completions。
  • 401:API Key 字段只粘贴密钥本身,不要加 Bearer 前缀;确认 Key 仍有效且账户有余额。
  • model_not_found:模型名称必须是 deepseek-flash;DeepSeek-V4.1-Flash 是显示名称,不是 Wokey 的模型 ID。
  • 图片请求失败:确认选的是 deepseek-flash 并打开图片输入;deepseek-v4-flash 只接受文本。
  • 429、502、504 或 529:先降低并发、缩短上下文或稍后重试;也可以切换到其他可用模型。

用 curl 验证link

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

WorkBuddy 默认使用 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": "deepseek-flash",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

错误与排障link

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

401

invalid api key

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

402

insufficient balance

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

403

model_denylisted / account_restricted

该模型或整个账号因反复违规被暂停调用,处理方法见「违规处置费与风控限制」。

403

request_blocked

这个请求被拦截,没有发往上游,也不收费。例如原样重发刚被模型拒绝的请求,或某个终端用户(X-End-User-Id)被暂停。报错信息会说明拦截的范围;按提示修改请求或稍后再试,其他请求不受影响。

429

rate limited

请求过于频繁,稍后重试或降低并发。如果只有某一个模型或某一个终端用户(X-End-User-Id)持续返回 429,可能是违规后的临时限流。

502

upstream unavailable

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

504

upstream timeout

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

529

upstream overloaded

上游模型暂时过载,Wokey 已先换线路重试过(code 为 upstream_overloaded),和你的余额无关。稍后重试或切换模型。