登录注册
快速开始其他 Agent

快速开始 / 接入 Agent 工具

接入其他 Agent

本文档没有单独介绍的 Agent 工具、编辑器插件和聊天客户端，只要支持自定义 API 地址，都可以接入本站。不同工具的设置界面各不相同，但要填的东西只有四样：接口格式、API 地址、API Key 和模型名。按下面的步骤逐项确认即可。

1. 确认工具支持的接口格式

本站同时提供三种接口格式。打开工具的模型设置，看它的「提供商类型」「Provider」「API 类型」之类的选项里有哪一种，对照下表选择，并填写对应的 API 地址：

接口格式设置里常见的叫法API 地址适合的模型
Anthropic MessagesAnthropic、Claude、anthropic-messageshttps://api.tokenjoy.orgClaude 系列，推荐
OpenAI Chat CompletionsOpenAI、OpenAI 兼容、OpenAI Compatible、openai-completionshttps://api.tokenjoy.org/v1全部模型，兼容性最好
OpenAI ResponsesOpenAI Responses、responseshttps://api.tokenjoy.org/v1GPT 系列，推荐

几条选择建议：

  • 工具同时支持多种格式时，用 Claude 模型选 Anthropic 格式，用 GPT 模型选 Responses 格式，思考过程、工具调用和缓存计费都最完整。
  • 只有「OpenAI 兼容」一种选项时也没问题：Chat Completions 格式可以调用本站的全部模型，包括 Claude。
  • 一个提供商通常只能选一种格式。想同时用 Claude 和 GPT 的原生格式，就添加两个提供商，分别填写。

2. 填对 API 地址

最常见的问题是地址里的 /v1 多了或少了。判断方法是看工具最终把请求发到哪里，正确的完整地址是：

接口格式完整的请求地址
Anthropic Messageshttps://api.tokenjoy.org/v1/messages
OpenAI Chat Completionshttps://api.tokenjoy.org/v1/chat/completions
OpenAI Responseshttps://api.tokenjoy.org/v1/responses
  • 大多数 OpenAI 格式的工具会在你填的地址后面加 /chat/completions，所以填 https://api.tokenjoy.org/v1。
  • Anthropic 官方 SDK 以及基于它的工具会自己加 /v1/messages，所以填 https://api.tokenjoy.org，不带 /v1。
  • 少数工具要求填写完整的请求地址（输入框提示里带有 /chat/completions），这时直接填上表中的完整地址。
  • 拿不准时先按上表填，测试时如果返回 404，再加上或去掉 /v1 试一次。

3. 填写 API Key 和模型名

API Key 填写本站的 Key，不要填 OpenAI 或 Anthropic 官方的 Key。API Key 在控制台的 API Keys 页创建。 本站同时接受 Authorization: Bearer 和 x-api-key 两种请求头，工具用哪一种都可以。

模型名必须与模型列表中的名字完全一致，例如 claude-sonnet-4-6、gpt-5。很多工具有「获取模型列表」或「拉取模型」按钮，会从 https://api.tokenjoy.org/v1/models 自动读取，可以直接勾选；没有这个按钮就手动输入。

如果工具要求填写上下文长度、最大输出 token 等参数，参照模型列表中的数值填写；不确定时保持默认。

4. 先用命令行确认 Key 和地址可用

在工具里排查问题比较费时，建议先在终端里确认 Key 和地址都没问题。先把 Key 设置为环境变量：

终端
export TOKENJOY_API_KEY="<你的 API Key>"

列出可用模型，能看到模型名就说明 Key 和地址都正确：

获取模型列表
curl https://api.tokenjoy.org/v1/models \
  -H "Authorization: Bearer $TOKENJOY_API_KEY"

再按工具要用的格式发一条最简单的请求，能收到回复就说明这种格式可用：

Anthropic 格式
curl https://api.tokenjoy.org/v1/messages \
  -H "x-api-key: $TOKENJOY_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 64, "messages": [{"role": "user", "content": "Hi"}]}'
OpenAI 格式
curl https://api.tokenjoy.org/v1/chat/completions \
  -H "Authorization: Bearer $TOKENJOY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "gpt-5", "messages": [{"role": "user", "content": "Hi"}]}'

5. 在工具中测试

保存设置后，在工具里选中刚添加的模型，发一条简单的消息。很多工具的设置页有「检查」「测试连接」按钮，也可以先点一下。然后到控制台的概览页，在「请求记录」里确认出现了这次调用。

常见问题

现象原因和解决办法
401 认证失败检查 Key 是否完整、有没有多余的空格或换行；确认 Key 在控制台中处于启用状态，账户余额充足
404 接口不存在API 地址的 /v1 多了或少了，对照第 2 步检查；也可能把 Anthropic 格式的地址填进了 OpenAI 格式的提供商
400 模型不存在模型名与模型列表不一致，注意大小写和版本号
请求仍然发往官方系统或终端里设置的 OPENAI_BASE_URL、ANTHROPIC_BASE_URL、OPENAI_API_KEY 等环境变量覆盖了工具里的设置，删除后重启工具
后台运行的工具读不到 Key通过系统服务或桌面图标启动的程序读不到终端里 export 的环境变量，把 Key 直接填进工具设置，或写进它自己的配置文件
Codex 的 /model 里只有 GPT 模型配置里缺少 model_catalog_url，重新运行接入 Codex里的一键命令，或手动加上这一行；仍然没有时升级 Codex
工具调用或思考过程异常换成该模型的原生格式：Claude 用 Anthropic 格式，GPT 用 Responses 格式

其他错误码的含义见错误码。仍然无法接入时，请把工具名称、版本和报错截图发给我们。

上一页Cherry Studio