使用文档

一个端点,
所有模型。

Tare 是挡在你所有模型前面的一层 OpenAI 兼容网关 —— 我们的,和你自己带来的。一个 base URL、一把 key,每一个 token 都算得清。

运维Call Traces

Call Traces

发送给模型的原文与模型的回答统称为调用内容。它与用量记录相互独立:用量(token 数、 花费、实际使用的路由)始终记录,是账单的依据;调用内容默认完全不存储。

默认不存储

新账号无需任何操作。控制台 → Call Traces 里的开关默认关闭,此时 request_content / response_content 两列为空 —— 即未曾存储,而非存储后不予展示。

[!NOTE] 对「请求体中含有客户代码和业务数据」这类顾虑:默认配置下,这些内容不会写入平台数据库。

开启后

留存条数默认保留最近 1,000 次调用,可配置 1–100,000
加密方式AES-256-GCM,密钥由平台保管,与渠道凭据分开存放
存储地域新加坡
访问权限账号所有者随时可查;未经授权平台不可读取
过期处理每天凌晨清理一次,超出留存条数之外的内容按从旧到新被抹除(用量行保留,仅内容两列置空)

内容密钥与渠道凭据分开保管,原因是轮换节奏不同:凭据泄漏需立即更换,而内容密钥一旦轮换, 历史记录需整表重新加密。

[!WARNING] 加密不等同于平台无法读取。 密钥保存在平台服务器上,「平台不可读」是一条制度约束 (授权 + 审计,见下),不是物理约束。

平台查看内容需要授权

排查问题时平台可能需要读取特定几次调用的内容,路径只有一条:由账号所有者在控制台 授予一段限时授权。

  • 授权时长 1 小时至 30 天,不提供「永久」选项:无时限的授权会在排查结束后持续有效。
  • 授权期内每次读取都会记录审计,可在 Audit 页查看。
  • 可随时提前收回;到期的自动失效,无需处理。
  • 未授权时平台读到的是 <withheld: customer has not granted access>,而不是内容。

关闭

可随时关闭。关闭后新调用不再写入内容;已存储的内容不会立即删除,按当时设置的留存条数 在下次清理时抹除超出部分。需要立即清空时,可将留存条数改为 1 —— 下次清理后只剩最近一次 调用的内容。

接口

控制台上的开关都有对应接口:

Code / Terminal
# 当前设置 + 授权状态
curl https://tare.jamerly.ai/v1/content-settings \
  -H "Authorization: Bearer $TARE_API_KEY"

# 打开保存,只留最近 100 次调用
curl -X PUT https://tare.jamerly.ai/v1/content-settings \
  -H "Authorization: Bearer $TARE_API_KEY" -H "Content-Type: application/json" \
  -d '{"enabled": true, "retentionCount": 100}'

# 授权平台查看 24 小时
curl -X POST https://tare.jamerly.ai/v1/content-settings/grants \
  -H "Authorization: Bearer $TARE_API_KEY" -H "Content-Type: application/json" \
  -d '{"hours": 24, "reason": "排查 502"}'

[!WARNING] productLine 只能放在 GET 的 query 上,写操作一律放在请求体里:前置网关会丢弃 POST/PUT 的 query string,写在 query 上的参数不报错,只是不生效。

文档最后更新于 2026 年 9 月 20 日 06:31(UTC+8)