TikBitTikBit

TikBit · API 接入指南

把 TikBit 模型,接进你熟悉的工具。

选择应用,按步骤接入,共用你的 TikBit 模型额度。

接入前,准备好这三项

01API 密钥

在控制台「API 密钥」中创建或复制。

前往密钥管理 →
02接口地址

按教程填写,别混用完整接口与 Base URL。

03模型 ID

复制精确模型名,确认权限与可用额度。

查看模型算力 →

密钥只填在你信任的本机应用中,不要贴到公开聊天、截图或代码仓库。本站指南不收集密钥。

图形界面配置 · Chat Completions

WorkBuddy

在自定义模型里添加 TikBit,回到对话框就能选择使用。

  1. 打开自定义模型设置

    点击对话框右下角的模型菜单,选择「配置自定义模型」,再点「添加模型」。提供商选择「自定义 / Custom」。

  2. 填写地址、密钥和模型

    完整接口地址 / Endpointhttps://tikbit.ai/v1/chat/completions

    API Key 填自己的 TikBit 密钥;模型名称每次填一个,从模型算力页复制。其他选项以当前 WorkBuddy 版本为准。

    如果你的版本要求「Base URL / API Host」,填 https://tikbit.ai/v1,由应用补全路径。不要重复拼接 /v1/chat/completions

  3. 保存,选择模型并测试

    回到模型菜单,选择刚添加的模型,新建对话发送「只回复 OK」。需要多个模型时,逐个添加。

怎样确认接入成功?

应用正常回复,且 TikBit 控制台对应时间出现该模型的调用记录。只看到模型名不代表请求已经进入 TikBit。

VS Code · Anthropic 兼容接口

Claude Code for VS Code

安装 Anthropic 发布的官方扩展。已有 TikBit 工作台的用户,可以把接入配置一次性同步给扩展。

已有 TikBit 工作台 · 推荐

让工作台里的 AI 帮你配置

把下面的操作指令交给能操作本机的 AI。它会查找当前有效配置、备份并修改 VS Code 扩展配置;密钥只在本机读取,不用发到聊天里。

下载完整指令 ↓
  1. 确认扩展的运行位置

    本机、WSL、SSH 远程和容器可能读取不同的配置。让 AI 先确认扩展版本、当前 Profile 和实际配置目录。

  2. 配置 Claude 接口

    ANTHROPIC_BASE_URLhttps://tikbit.ai

    认证使用 TikBit 提供的 ANTHROPIC_AUTH_TOKENANTHROPIC_API_KEY 配置方式;沿用工作台实际有效的那一种,避免重复变量冲突。模型请求使用 /v1/messages,不要填入 OpenAI 的对话接口。

    需要检查扩展的 claudeCode.environmentVariables、Claude 配置文件 settings.json 中的 env 及覆盖关系。关闭登录提示不等于切换了 API。

  3. 在扩展里验证

    保存工作后正常退出并重新打开 VS Code,在 Claude Code 扩展中新建对话,发一条简短消息,再核对 TikBit 调用记录。

没有安装 TikBit 工作台?先准备自己的 TikBit 密钥、地址和可用 Claude 模型 ID,按当前扩展版本配置;上方自动同步指令以已有工作台为前提。

VS Code · Responses API

Codex – OpenAI's coding agent

安装 OpenAI 发布的官方 VS Code 扩展,使用 TikBit 的 Responses 接口进行本地协作。

已有 TikBit 工作台 · 推荐

让 AI 一次性同步接入配置

沿用工作台当前有效的 Codex 地址与密钥,同时保留 VS Code 自己的配置、登录凭据和历史。

下载完整指令 ↓

接入时核对这几项

Codex Base URLhttps://tikbit.ai/v1
  • 在扩展实际读取的 config.toml 中定义并选中 TikBit provider,协议为 responses
  • model_provider 是顶层字段;只写 provider 配置而未选中,不会切换服务。
  • 让 VS Code 启动的 Codex 子进程真正获得密钥。仅在另一终端设置环境变量不够。
  • 不要把 VS Code 的 CODEX_HOME 指向 TikBit 工作台私有目录。
必须在 VS Code 扩展里验收

重启后新建对话,分别测试简短回复、在空测试文件夹创建并读取文件,再核对 TikBit 调用记录。独立 CLI 或 curl 成功不能代替扩展验收。

官方桌面应用 · Responses API

Codex 桌面端

让官方 Codex 桌面客户端的本地任务通过 TikBit 调用模型。Windows 和 macOS 分别处理应用启动环境。

本指南适用于支持自定义模型服务的 Codex 桌面版本,仅配置本地任务。云端任务仍按应用自身的服务设置运行。

把完整指南交给本机 AI

指令包含环境检查、备份、配置、Windows/macOS 密钥接入、桌面端验证和恢复方法。密钥由你在本机安全输入。

下载完整指南 ↓

需要生效的配置结构

把以下字段合并到已有配置,不能覆盖整个文件。将 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 选项的客户端版本。若启用开发者模式后仍找不到该选项,请检查客户端版本是否支持第三方模型接入。

  1. 保存工作,停在登录页

    从登录页开始配置。已登录的用户请先保存当前任务,退出账号后重新打开客户端。

  2. 启用开发者模式

    打开 Help → Troubleshooting → Enable developer mode。如未出现 Developer 菜单,正常重启后再检查。

  3. 填写第三方推理配置

    打开 Developer → Configure third-party inference,填写 Base URL 和 API Key。

    TikBit Base URLhttps://tikbit.ai

    API Key 填写自己的 TikBit 密钥。Base URL 使用上方根地址,不需要添加 /v1/chat/completions

  4. 应用配置并分别验证能力

    点击 Apply locally,等待客户端重启。先测试简短对话,再在空测试文件夹验证 Cowork 文件任务,并核对 TikBit 调用记录。聊天成功不能替代 Cowork 功能验收。

配置仅对当前设备生效,换电脑后需要重新设置。

其他工具 · 自己的程序

按协议选择接口

先看工具要求哪种协议,再填相应地址。模型可见不等于该工具或协议能调用它。

OpenAI Chat Completions

适用于支持该协议的自定义聊天工具。

Base URLhttps://tikbit.ai/v1

实际请求:POST /v1/chat/completions

OpenAI Responses

Codex 需要 Responses 兼容性,不能只提供 Chat Completions。

Base URLhttps://tikbit.ai/v1

实际请求:POST /v1/responses

Anthropic Messages

适用于 Claude Code 等支持 Anthropic 协议的工具。

Base URLhttps://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,不要发送完整密钥查看工作台使用指南 ↗

请手动复制

浏览器暂不允许自动复制,内容已为你选中。