开工 API 接入文档
开工 API 兼容 OpenAI 与 Anthropic 的接口格式。用开工账户登录 API 控制台 创建 Key 并充值余额后,把下面的 Base URL 和 Key 填进客户端即可。
快速开始
一键接入客户端
在 一键接入客户端 页面勾选 Codex(CLI / 桌面版)、Claude Code、Claude 桌面版、DeepSeek Harness(CLI / 桌面版)或 WorkBuddy,网站生成一行只能使用一次的命令:
开工连接器会:检查并安装所选客户端(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 | 官方价同价或以上 |
| 特价版 Special | claude-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 | 官方价同价或以上 |
| 特价版 Special | claude-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 | 官方价同价或以上 |
| 特价版 Special | claude-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 | 官方价同价或以上 |
| 特价版 Special | claude-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 | 官方价同价或以上 |
| 特价版 Special | gpt-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 | 官方价同价或以上 |
| 特价版 Special | gpt-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 | 官方价同价或以上 |
| 特价版 Special | gpt-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 折 |
| 特价版 Special | gpt-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 | 官方价同价或以上 |
| 特价版 Special | grok-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,切换模型需改这一行后重启;连接器还会写入模型目录(上下文长度、思考强度),让 Codex 正确压缩上下文。
Claude Code
写入 ~/.claude/settings.json 的 env,对终端、IDE 插件和后台任务都生效:
模型 ID 可以是任一已开放模型(包括非 Claude 模型,由开工 API 转换协议)。
Claude 桌面版
Claude 桌面版以“第三方推理”模式连接开工 API(Code 与 Cowork 可用)。手动配置:帮助 → 故障排除 → 启用开发者模式,然后 Developer → Configure Third-Party Inference,推理提供方选 Gateway:
连接器在 Windows 上把同样的配置写入 HKCU\SOFTWARE\Policies\Claude(需要一次管理员授权),完全退出并重新打开 Claude 后生效。
DeepSeek Harness(CLI 与桌面版)
CLI 与 Windows 桌面版共用 ~/.dsh(或 DSH_HOME)下的配置。在 设置 → 模型 → 添加模型提供方 中选择自定义模型 API,或在 ~/.dsh/cordis.patch.yml 中加入:
并把 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:
Cherry Studio 及其他客户端
选择“OpenAI 兼容”类型,API 地址填 https://api.kaigongs.com/v1(部分客户端只填 https://api.kaigongs.com,会自动补 /v1),密钥填 sk-kg- 开头的 Key,再从模型列表中选择或手动输入模型 ID。支持 Anthropic 格式的客户端也可以直接填 Anthropic 兼容地址。
HTTP 示例
同一会话请保持相同的请求结构;客户端发送会话标识(如 session_id 或 x-session-id 请求头)时,同一会话会尽量留在同一通道上以利用缓存。
计费与余额
- 按输入、缓存读取、缓存写入、输出 token 分别计价,单位元/百万 token;长上下文按模型规则另计档位。
- 每次调用前按预计用量预留余额,结束后按实际用量扣费并释放剩余预留。
- 调用时冻结当时的价目表;调价会提前公告,不影响已发起的调用。
- API 余额与开工客户端积分是两个独立账户,不能互相抵扣。
限速与额度
每个 Key 默认每分钟 60 次请求,可在控制台为每个 Key 单独设置每分钟请求数、每日与每月消费上限,以及允许调用的模型。每个账户最多保留 20 个有效 Key。
错误码
| 状态与代码 | 含义 |
|---|---|
401 INVALID_ACCESS_TOKEN | Key 不存在、已删除、已停用或已过期。 |
402 INSUFFICIENT_BALANCE | API 余额不足以预留本次调用,请充值。 |
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":"…"}}。