TikBit · API 接入指南
把 TikBit 模型,接进你熟悉的工具。
选择应用,按步骤接入,共用你的 TikBit 模型额度。
接入前,准备好这三项
密钥只填在你信任的本机应用中,不要贴到公开聊天、截图或代码仓库。本站指南不收集密钥。
图形界面配置 · Chat Completions
WorkBuddy
在自定义模型里添加 TikBit,回到对话框就能选择使用。
打开自定义模型设置
点击对话框右下角的模型菜单,选择「配置自定义模型」,再点「添加模型」。提供商选择「自定义 / Custom」。
填写地址、密钥和模型
完整接口地址 / Endpointhttps://tikbit.ai/v1/chat/completionsAPI Key 填自己的 TikBit 密钥;模型名称每次填一个,从模型算力页复制。其他选项以当前 WorkBuddy 版本为准。
如果你的版本要求「Base URL / API Host」,填
https://tikbit.ai/v1,由应用补全路径。不要重复拼接/v1或/chat/completions。保存,选择模型并测试
回到模型菜单,选择刚添加的模型,新建对话发送「只回复 OK」。需要多个模型时,逐个添加。
应用正常回复,且 TikBit 控制台对应时间出现该模型的调用记录。只看到模型名不代表请求已经进入 TikBit。
VS Code · Anthropic 兼容接口
Claude Code for VS Code
安装 Anthropic 发布的官方扩展。已有 TikBit 工作台的用户,可以把接入配置一次性同步给扩展。
让工作台里的 AI 帮你配置
把下面的操作指令交给能操作本机的 AI。它会查找当前有效配置、备份并修改 VS Code 扩展配置;密钥只在本机读取,不用发到聊天里。
下载完整指令 ↓确认扩展的运行位置
本机、WSL、SSH 远程和容器可能读取不同的配置。让 AI 先确认扩展版本、当前 Profile 和实际配置目录。
配置 Claude 接口
ANTHROPIC_BASE_URLhttps://tikbit.ai认证使用 TikBit 提供的
ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY配置方式;沿用工作台实际有效的那一种,避免重复变量冲突。模型请求使用/v1/messages,不要填入 OpenAI 的对话接口。需要检查扩展的
claudeCode.environmentVariables、Claude 配置文件settings.json中的env及覆盖关系。关闭登录提示不等于切换了 API。在扩展里验证
保存工作后正常退出并重新打开 VS Code,在 Claude Code 扩展中新建对话,发一条简短消息,再核对 TikBit 调用记录。
没有安装 TikBit 工作台?先准备自己的 TikBit 密钥、地址和可用 Claude 模型 ID,按当前扩展版本配置;上方自动同步指令以已有工作台为前提。
VS Code · Responses API
Codex – OpenAI's coding agent
安装 OpenAI 发布的官方 VS Code 扩展,使用 TikBit 的 Responses 接口进行本地协作。
接入时核对这几项
https://tikbit.ai/v1- 在扩展实际读取的
config.toml中定义并选中 TikBit provider,协议为responses。 model_provider是顶层字段;只写 provider 配置而未选中,不会切换服务。- 让 VS Code 启动的 Codex 子进程真正获得密钥。仅在另一终端设置环境变量不够。
- 不要把 VS Code 的
CODEX_HOME指向 TikBit 工作台私有目录。
重启后新建对话,分别测试简短回复、在空测试文件夹创建并读取文件,再核对 TikBit 调用记录。独立 CLI 或 curl 成功不能代替扩展验收。
官方桌面应用 · Responses API
Codex 桌面端
让官方 Codex 桌面客户端的本地任务通过 TikBit 调用模型。Windows 和 macOS 分别处理应用启动环境。
本指南适用于支持自定义模型服务的 Codex 桌面版本,仅配置本地任务。云端任务仍按应用自身的服务设置运行。
需要生效的配置结构
把以下字段合并到已有配置,不能覆盖整个文件。将 YOUR_MODEL_ID 换成你的密钥已确认支持 Responses 的精确模型 ID。
model = "YOUR_MODEL_ID"
model_provider = "tikbit"
[model_providers.tikbit]
name = "TikBit"
base_url = "https://tikbit.ai/v1"
wire_api = "responses"
env_key = "TIKBIT_API_KEY"
requires_openai_auth = false
把密钥保存到应用实际能读取的 TIKBIT_API_KEY 环境变量或指南指定的安全存储中。requires_openai_auth = false 表示使用自定义服务认证,仍需 TikBit 密钥。
Windows 需核对用户环境变量;macOS 从 Dock 启动通常不会读取终端配置。按完整指南设置启动入口,并完成「退出 → 重开 → 新建对话 → 文件工具调用」验收。
Claude Desktop / Cowork · 桌面应用
Claude Desktop Cowork
通过桌面客户端的第三方推理配置入口填写 API 信息,适合偏好图形界面的用户。
适用于提供 Configure third-party inference 选项的客户端版本。若启用开发者模式后仍找不到该选项,请检查客户端版本是否支持第三方模型接入。
保存工作,停在登录页
从登录页开始配置。已登录的用户请先保存当前任务,退出账号后重新打开客户端。
启用开发者模式
打开
Help → Troubleshooting → Enable developer mode。如未出现 Developer 菜单,正常重启后再检查。填写第三方推理配置
打开
Developer → Configure third-party inference,填写 Base URL 和 API Key。TikBit Base URLhttps://tikbit.aiAPI Key 填写自己的 TikBit 密钥。Base URL 使用上方根地址,不需要添加
/v1/chat/completions。应用配置并分别验证能力
点击
Apply locally,等待客户端重启。先测试简短对话,再在空测试文件夹验证 Cowork 文件任务,并核对 TikBit 调用记录。聊天成功不能替代 Cowork 功能验收。
配置仅对当前设备生效,换电脑后需要重新设置。
其他工具 · 自己的程序
按协议选择接口
先看工具要求哪种协议,再填相应地址。模型可见不等于该工具或协议能调用它。
OpenAI Chat Completions
适用于支持该协议的自定义聊天工具。
https://tikbit.ai/v1实际请求:POST /v1/chat/completions
OpenAI Responses
Codex 需要 Responses 兼容性,不能只提供 Chat Completions。
https://tikbit.ai/v1实际请求:POST /v1/responses
Anthropic Messages
适用于 Claude Code 等支持 Anthropic 协议的工具。
https://tikbit.ai实际请求:POST /v1/messages
自己写程序:最小 Responses 请求示例
先在本机为请求进程安全提供 TIKBIT_API_KEY;将模型占位符替换为可用 ID。下面是 Bash / macOS / Linux 示例,会产生正常 API 用量。
curl https://tikbit.ai/v1/responses \
-H "Authorization: Bearer $TIKBIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_MODEL_ID","input":"只回复 OK","stream":true}'检查实际输出和正常完成事件,不能只看 HTTP 200。不要把真实密钥直接写进命令历史。
卡住时,先看这里
接入常见问题
401 / 密钥无效
检查密钥是否完整、是否启用,以及目标应用进程是否真的拿到了密钥。不要把网站登录密码当作 API 密钥。
404 / 找不到接口或模型
先读错误正文:检查地址是否重复了 /v1,是否误把完整接口当成 Base URL;再核对模型 ID、密钥分组与接口协议。
403 / 模型无权限,或 429 / 请求受限
403 根据错误区分账户权限、模型权限和网关策略。429 检查频率、并发、额度及上游状态,遵守服务端等待提示,不要连续重试。
终端能用,扩展或桌面应用不能用
优先检查运行环境、配置目录、Profile 和密钥继承;保存工作后正常重启应用,新建对话再测试。不要先删除登录记录或清空配置目录。
能聊天,但不能操作文件
分别检查工具调用协议兼容性、工作目录授权和正常审批。模型在正文里写出工具代码不代表真正调用了工具,不要通过关闭审批或降低安全设置来修复接入。
仍然无法接入?反馈工具与版本、发生时间、模型 ID、脱敏错误及请求 ID,不要发送完整密钥。查看工作台使用指南 ↗

