开工 API 接入文档

开工 API 兼容 OpenAI 与 Anthropic 的接口格式。用开工账户登录 API 控制台 创建 Key 并充值余额后,把下面的 Base URL 和 Key 填进客户端即可。

快速开始

  1. 登录后在 API Key 页面创建 Key。Key 只显示一次,请立即保存。
  2. 在 余额与充值 充值或兑换余额。
  3. 在客户端填写 Base URL、Key 和模型 ID。
OpenAI 兼容 Base URL https://api.kaigongs.com/v1 Anthropic 兼容 Base URL https://api.kaigongs.com 鉴权 Authorization: Bearer sk-kg-…(Anthropic 客户端也可用 x-api-key) 模型列表 GET https://api.kaigongs.com/v1/models API 余额 GET https://api.kaigongs.com/v1/balance

一键接入客户端

在 一键接入客户端 页面勾选 Codex(CLI / 桌面版)、Claude Code、Claude 桌面版、DeepSeek Harness(CLI / 桌面版)或 WorkBuddy,网站生成一行只能使用一次的命令:

Windows(PowerShell) irm <网站>/i/KGC-XXXX-XXXX-XXXX-XXXX | iex macOS / Linux(终端) curl -fsSL "<网站>/i/KGC-…?shell=sh" | sh

开工连接器会:检查并安装所选客户端(CLI 通过国内 npm 镜像,桌面版使用官方安装包)→ 为每个客户端创建单独的 Key → 备份并合并写入客户端配置(保留你原有的 MCP、项目等设置)→ 验证连接。撤销最近一次修改运行 irm <网站>/i/restore | iex。不想运行脚本时,按下面各节手动配置。

开工 API 在服务端转换协议:Codex(Responses 格式)、Claude Code 与 Claude 桌面版(Messages 格式)、WorkBuddy(Chat Completions 格式)都可以调用列表中的任一模型,计价相同。

模型与版本

每个模型提供两个版本,模型 ID 决定版本:

  • 稳定版:模型 ID 即模型名(如 claude-fable-5-1),经 OpenRouter 调用正规部署,排除低精度版本。
  • 特价版 Special:模型 ID 加 -special(如 claude-fable-5-1-special),只使用已核价的低价中转渠道,按本次请求成本择优、失败自动切换。

两个版本之间不会互相切换:选了特价版,就不会在你不知情时按稳定版价格扣费。特价版暂时没有可用通道时会返回错误,你可以自行改用稳定版。

模型版本模型 ID输入缓存读取缓存写入输出对比官方价
Claude Fable 5.1稳定版claude-fable-5-1¥76.5081¥1.9127¥95.6352¥382.5407官方价同价或以上
特价版 Specialclaude-fable-5-1-special¥19.0339¥0.4758¥23.7924¥95.1695约官方价 2.8 折
Claude Haiku 5.5稳定版claude-haiku-5.5¥0.7651¥0.0765¥0.9564¥3.8254官方价同价或以上
特价版 Specialclaude-haiku-5.5-special¥0.0825¥0.0083¥0.1031¥0.4125约官方价 1.2 折
Claude Opus 5.5稳定版claude-opus-5.5¥30.6033¥1.5302¥38.2541¥153.0163官方价同价或以上
特价版 Specialclaude-opus-5.5-special¥3.2918¥0.1646¥4.1148¥16.4592约官方价 1.2 折
Claude Sonnet 5.5稳定版claude-sonnet-5.5¥15.3016¥0.7651¥19.127¥76.5081官方价同价或以上
特价版 Specialclaude-sonnet-5.5-special¥1.7377¥0.0869¥2.1722¥8.6887约官方价 1.3 折
DeepSeek V4.1 Flash稳定版deepseek-v4.1-flash¥0.499¥0.01¥0.499¥1.9959约官方价 5 折
DeepSeek V4.1 Flash 1017稳定版deepseek/deepseek-v4.1-flash-1017¥1.2729¥0.0255¥1.2729¥5.0915官方价同价或以上
GPT-5.6 Sol稳定版gpt-5.6-sol¥30.6033¥3.0603¥38.2541¥153.0163官方价同价或以上
特价版 Specialgpt-5.6-sol-special¥1.2614¥0.1261¥1.5767¥6.3069约官方价 0.4 折
GPT-6 Astra稳定版gpt-6-astra¥76.5081¥7.6508¥95.6352¥382.5407官方价同价或以上
特价版 Specialgpt-6-astra-special¥3.1535¥0.3153¥3.9418¥15.7673约官方价 0.4 折
GPT-6 Sol稳定版gpt-6-sol¥15.3016¥1.5302¥19.127¥76.5081官方价同价或以上
特价版 Specialgpt-6-sol-special¥0.6307¥0.0631¥0.7884¥3.1535约官方价 0.4 折
GPT-6.1 Sol稳定版gpt-6.1-sol¥7.6508¥0.3825¥9.5635¥38.2541约官方价 5.7 折
特价版 Specialgpt-6.1-sol-special¥0.6307¥0.0315¥0.7884¥3.1535约官方价 0.4 折
Grok 4.7稳定版grok-4.7¥15.3016¥3.8254¥15.3016¥45.9049官方价同价或以上
特价版 Specialgrok-4.7-special¥0.6307¥0.1577¥0.6307¥1.8921约官方价 0.4 折

单位:元 / 百万 token。长上下文档位按模型官方规则另计;实际扣费以调用时冻结的价目表为准,调价会提前在本页公告。

Codex

Codex CLI 与 Codex 桌面版共用 ~/.codex/config.toml(Windows 为 %USERPROFILE%\.codex\config.toml)。在文件开头的顶层设置和末尾分别加入:

model = "claude-fable-5-1" model_provider = "kaigong" preferred_auth_method = "apikey" forced_login_method = "api" [model_providers.kaigong] name = "开工 API" base_url = "https://api.kaigongs.com/v1" wire_api = "responses" experimental_bearer_token = "sk-kg-…"

桌面版只读取顶层的 model,切换模型需改这一行后重启;连接器还会写入模型目录(上下文长度、思考强度),让 Codex 正确压缩上下文。

Claude Code

写入 ~/.claude/settings.json 的 env,对终端、IDE 插件和后台任务都生效:

{ "env": { "ANTHROPIC_BASE_URL": "https://api.kaigongs.com", "ANTHROPIC_AUTH_TOKEN": "sk-kg-…", "ANTHROPIC_MODEL": "claude-fable-5-1", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-fable-5-1", "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1" } }

模型 ID 可以是任一已开放模型(包括非 Claude 模型,由开工 API 转换协议)。

Claude 桌面版

Claude 桌面版以“第三方推理”模式连接开工 API(Code 与 Cowork 可用)。手动配置:帮助 → 故障排除 → 启用开发者模式,然后 Developer → Configure Third-Party Inference,推理提供方选 Gateway:

Gateway base URL https://api.kaigongs.com Gateway API key sk-kg-… Models claude-fable-5-1(按需添加其他模型 ID)

连接器在 Windows 上把同样的配置写入 HKCU\SOFTWARE\Policies\Claude(需要一次管理员授权),完全退出并重新打开 Claude 后生效。

DeepSeek Harness(CLI 与桌面版)

CLI 与 Windows 桌面版共用 ~/.dsh(或 DSH_HOME)下的配置。在 设置 → 模型 → 添加模型提供方 中选择自定义模型 API,或在 ~/.dsh/cordis.patch.yml 中加入:

- id: llm-pi-ai config: providers: kaigong: apiKeyEnv: KAIGONG_DSH_API_KEY api: openai-completions baseURL: "https://api.kaigongs.com/v1" models: - id: "claude-fable-5-1"

并把 Key 设为环境变量 KAIGONG_DSH_API_KEY(Windows:setx KAIGONG_DSH_API_KEY sk-kg-…),重启后生效。

WorkBuddy

设置 → 模型 → 添加自定义模型,类型选 Custom / OpenAI 兼容,Base URL 填 https://api.kaigongs.com/v1,API Key 填 sk-kg- 开头的 Key,模型填模型 ID。也可以编辑 %USERPROFILE%\.workbuddy\models.json:

{ "models": [ { "id": "claude-fable-5-1", "name": "claude-fable-5-1(开工)", "vendor": "Custom", "url": "https://api.kaigongs.com/v1", "apiKey": "sk-kg-…", "supportsToolCall": true, "supportsImages": false, "supportsReasoning": true } ] }

Cherry Studio 及其他客户端

选择“OpenAI 兼容”类型,API 地址填 https://api.kaigongs.com/v1(部分客户端只填 https://api.kaigongs.com,会自动补 /v1),密钥填 sk-kg- 开头的 Key,再从模型列表中选择或手动输入模型 ID。支持 Anthropic 格式的客户端也可以直接填 Anthropic 兼容地址。

HTTP 示例

curl https://api.kaigongs.com/v1/chat/completions \ -H "Authorization: Bearer $KAIGONG_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"claude-fable-5-1-special","messages":[{"role":"user","content":"你好"}]}'
curl https://api.kaigongs.com/v1/messages \ -H "x-api-key: $KAIGONG_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "Content-Type: application/json" \ -d '{"model":"claude-fable-5-1","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

同一会话请保持相同的请求结构;客户端发送会话标识(如 session_id 或 x-session-id 请求头)时,同一会话会尽量留在同一通道上以利用缓存。

计费与余额

  • 按输入、缓存读取、缓存写入、输出 token 分别计价,单位元/百万 token;长上下文按模型规则另计档位。
  • 每次调用前按预计用量预留余额,结束后按实际用量扣费并释放剩余预留。
  • 调用时冻结当时的价目表;调价会提前公告,不影响已发起的调用。
  • API 余额与开工客户端积分是两个独立账户,不能互相抵扣。

限速与额度

每个 Key 默认每分钟 60 次请求,可在控制台为每个 Key 单独设置每分钟请求数、每日与每月消费上限,以及允许调用的模型。每个账户最多保留 20 个有效 Key。

错误码

状态与代码含义
401 INVALID_ACCESS_TOKENKey 不存在、已删除、已停用或已过期。
402 INSUFFICIENT_BALANCEAPI 余额不足以预留本次调用,请充值。
403 MODEL_NOT_ALLOWED_FOR_KEY该 Key 被限制为只能调用部分模型。
404 MODEL_NOT_OFFERED模型 ID 不存在或该版本暂未开放,请对照模型列表。
429 RATE_LIMITED超过该 Key 每分钟请求数,稍后重试。
429 API_KEY_SPEND_LIMIT超过该 Key 的每日或每月消费上限。
503 MODEL_ROUTE_UNAVAILABLE该版本此刻没有健康的可用通道(冷却、故障复查或未配置);稍后重试,特价版可改用稳定版。
503 MODEL_MARGIN_UNAVAILABLE该版本此刻没有满足定价条件的供应通道;稍后重试,或改用另一版本(稳定版 / 特价版)。

错误响应格式为 {"error":{"code":"…","message":"…"}}。