Tavo 用户对接指南

本文介绍如何在 Tavo 中接入 Claude 模型，并配置扩展思考与提示词缓存。

准备工作

开始前，请确认已经准备好：

• 可以正常使用的 Tavo 客户端
• 站内提供的 API 密钥
• API 接口地址：https://ai.xxcd.top/v1

注意

API 密钥属于敏感信息，请勿发送给他人，也不要在公开截图中展示完整内容。

配置 API 连接

1. 打开 API 连接

进入 Tavo 的 API 设置，新增或编辑一个 API 连接。

2. 填写连接信息

按照以下内容进行配置：

配置项	设置内容
名称	自定义，例如 API 1
模型平台	自定义（Anthropic 协议）
API 接口地址	https://ai.xxcd.top/v1
API 密钥	填写站内提供的 API 密钥
模型	选择需要使用的 Claude 模型

配置效果如下图所示：

3. 保存配置

确认接口地址和 API 密钥无误后，点击页面底部的 保存。

TIP

可选模型以 Tavo 页面中实际显示的列表为准。如果模型无法使用，请先确认当前密钥是否支持该模型。

开启扩展思考

1. 进入 API 设置页面。
2. 点击右上角的 齿轮图标。
3. 找到 扩展思考，将其开启。
4. 保存设置并返回。

开启后，支持该功能的 Claude 模型可以在复杂任务中进行更充分的推理。

配置提示词缓存

进入 API 设置页面，点击右上角的 齿轮图标，然后在页面最下方找到 自定义参数。

开启 5 分钟缓存

填写以下 JSON：

{
  "cache_control": {
    "type": "ephemeral"
  }
}

该配置会开启有效期为 5 分钟 的缓存。

开启 1 小时缓存

填写以下 JSON：

{
  "cache_control": {
    "type": "ephemeral",
    "ttl": "1h"
  }
}

该配置会开启有效期为 1 小时 的缓存。

JSON 格式

自定义参数必须是有效的 JSON。请使用英文双引号，不要添加注释或多余的尾随逗号。如果原本已有其他自定义参数，请将 cache_control 合并到原有 JSON 对象中，不要直接覆盖其他配置。

配置完成后保存 API 设置，即可使缓存参数生效。

常见问题

无法连接 API

依次检查：

1. 模型平台是否选择了 自定义（Anthropic 协议）。
2. API 接口地址是否完整填写为 https://ai.xxcd.top/v1。
3. API 密钥是否正确，且前后没有多余空格。
4. 当前选择的模型是否在密钥支持范围内。

自定义参数无法保存

请检查 JSON 是否使用英文双引号、括号是否完整，以及最后一个字段后是否存在多余逗号。

扩展思考没有生效

请确认所选模型支持扩展思考，并检查右上角齿轮菜单中的开关是否已经开启。