Tavily 套餐 Credits、Key 用量与 PAYG 接入教程

不托管 Key，手动查看用量

1. 自行登录 Dashboard，确认业务实际使用的账户/团队，查看套餐和 API keys 的 Monthly Limit。
2. 由已有 Owner 看 Billing 的套餐与 PAYG；paid/team 从侧栏 Usage 看统计。无页面/权限就请已有负责人核对，不提升角色或升级。
3. 账户、Key、PAYG 按各自单位分别比较，不合计；每月 1 日计数重置和订阅扣款日分开，不猜精确时区。

在 Quota Monitor 中接入 Tavily · 账户套餐与 Key 额度

1. 01

   确认正确账户/团队与现有套餐

   打开官方 Dashboard，确认当前账户/团队与业务 Key 相同，再检查 Billing 的现有套餐。个人、团队和本站项目不是同一范围。

   只有已有 Owner 能看团队 Billing，Admin/Member 不同；不能由控制台角色猜 /usage 最低权限。无现有访问或不能接受 Key 风险时手动查账，不提升角色或买套餐。

   打开官方 Dashboard（在新标签页打开）
2. 02

   创建独立监控 Key

   在 Dashboard 的 API keys 区点击 +，填写名称如 QuotaMonitorUsage。使用当前账号已允许的 Key 类型，私下保存完整 tvly- 秘密值，不是 ID 或末四位。

   Development/Production 是速率类别，不是读/写授权。不要为监控选择需要升级或 PAYG 的类型。登录后具体控件和最低权限尚待用户验证。

   官方 Key 创建步骤（在新标签页打开）
3. 03

   核对 Monthly Limit 与真实权限边界

   创建流程的 Monthly Limit 控制 API Credits，不是 usage-only scope，也没有已确认的只读权限 JSON。小上限、独立名称与 Development 都不会禁止收费工作。

   保留现有安全设置，只核对上限，不修改业务 Key、PAYG 或团队角色。403 不通过扩大授权排错；要求严格只读时不要托管普通 Key。

4. 04

   在本站选择套餐与 Key 额度

   在 Quota Monitor 目标项目添加连接，选择「Tavily · 账户套餐与 Key 额度」，填写名称。MCP 的安全录入链接使用 tavily，不要在聊天或工具参数发送秘密值。

   无需账户/团队/项目/Key ID、X-Project-ID、API 地址或货币预算。XXX 是非货币；本站项目不拆分上游套餐，只读 GET /usage，不发收费测试。

5. 05

   仅在遮蔽字段保存完整 Key

   把完整 tvly- Key 粘贴到安全录入页密码框后保存，不附 Bearer、URL、Cookie 或 JSON。凭据加密存储，其他视图只显示末四位，语法通过不证明权限和范围正确。

   帮助抽屉不读取或提交输入；关闭后继续填写，取消时清空。不截图秘密值、不复用关键业务 Key，不用搜索、抓取或 Research 验证连接。

6. 06

   首次同步并分别对账

   等待首次同步或刷新额度，确认新的成功时间。account.plan_usage=500、plan_limit=15000 时套餐推导剩余 14500 Credits；key.usage=150、key.limit=1000 时 Key 推导空间 850 Credits。

   14500 与 850 不相加，也不是现金/保证可调用额度。used 超限时 remaining=0、overage 为差值而非费用；key.limit=null 仅无该 Key 上限。失败保留旧值与原成功时间。

7. 07

   独立查看 PAYG 与重置日期

   在同一账户 Billing 看既有 PAYG 与套餐；paid/team 的侧栏 Usage 可辅助对账，免费账户无该页时不升级。paygo_usage=25、paygo_limit=100 仅原样显示，单位未文档化，不称美元/Credits或推算 75 资金。

   Credits/计数按官方帮助每月 1 日重置，订阅扣款可在其他日。接口无精确时间/时区，resetsAt/timeZone=null；不拿下个 UTC 月初、扣款日或查询时间代替。

   打开官方 Billing（在新标签页打开）
8. 08

   排错并安全轮换

   401 核对完整 tvly- Key、撤销状态与同一账户；403 检查既有访问，404 保留旧快照且不换端点，429 等待。缺字段/格式失败不是零额度，只反馈无秘密错误码和时间，不粘贴上游原文。

   创建替代监控 Key，经本站安全更新确认成功后仅撤销旧监控 Key，不动其他应用。不要为同步提高角色、启用 PAYG、充值或发收费请求。

   官方轮换步骤（在新标签页打开）

Quota Monitor 读取的 Tavily · 账户套餐与 Key 额度 数据范围

• 同一账户/团队套餐由多个 Key/本站项目共享，不加总重复连接。套餐、Key 与 PAYG 不相加，不取三者最小值推断可调用量。
• 只有明确 key.limit=null 表示无单 Key 上限；账户限制仍适用。缺失必需计数判失败，0 是真实上限；remaining/overage 是各自 limit-used 的推导值，不是官方钱包。
• /usage 对 paygo_usage 只写 usage count，对 paygo_limit 只写 usage limit，未明确 Credits/美元。以 not_documented 保留原始整数，不换算、不相减，不套用 Billing 金额或 org-usage 的独立 USD 字段。缺失/null 是未知，不是无限或已关闭。
• 官方帮助说 Credits/PAYG 计数每月 1 日重置、订阅扣款日独立；/usage 称 current billing cycle 却不返回边界/时区。resetsAt/timeZone=null，不猜 UTC 月初。
• 仅保留已知公开套餐名称，未知自定义名称不保存。操作细分/身份/Key 明细不入库，不调用 Logs、Enterprise org-usage、收费工作或设置写接口；查询时间非结算保证。
• Dashboard 展示最近一次成功的套餐额度或消费上限快照。刷新不能消除上游报告延迟；失败后保留的旧值和时间不是新结果，也不是钱包余额。

Tavily · 账户套餐与 Key 额度 常见问题与排查

这是现金余额吗？

不是。套餐/单 Key 是 Credits 计数与上限，剩余为同范围 limit-used 推导值。现金、退款资金、发票费用与总可调用额度没有读取，金额字段为 null。

无 Key 上限或零套餐剩余意味着什么？

明确 key.limit=null 仅无单 Key 上限，账户限制仍适用。套餐为零不能证明所有请求停止；PAYG/其他限制独立。0 不当无限，缺字段判失败。

PAYG 为什么不标美元或 Credits？

/usage 的 paygo_usage/paygo_limit 描述未明确单位，只照录原始整数。Billing 金额、价目表或 org-usage 的 paygo_cost_usd 不能自动套用；不相减/合计/估费，真实单位待用户与官方核对。

为何没有精确重置倒计时？

帮助说明自然月 1 日计数重置、订阅扣款日独立；/usage 不返边界/时区且称 billing cycle。精确时间未知，不生成 UTC 月初或从账单日期推算。

能配只读 Key 或权限 JSON 吗？

未确认 usage-only scope。普通 Key 可消费，Development 和 Monthly Limit 都不是只读。不要改用 Enterprise 所有者个人 Key 扩大范围；必须只读时手动查看。

401、403、429、旧数据或计数不同怎么办？

核对完整 Key、同一账户/团队、撤销与现有访问，429 等待。区分套餐/Key/PAYG 和重置，旧值看原时间。不分享 Key、提权、启用 PAYG 或收费测试。

Tavily · 账户套餐与 Key 额度 官方资料

• 官方 Usage API（在新标签页打开）
• 官方 OpenAPI（在新标签页打开）
• 官方 Key 与 Monthly Limit（在新标签页打开）
• 官方 Key 安全和轮换（在新标签页打开）
• 官方 Credits 重置（在新标签页打开）
• 官方 PAYG 和账单重置（在新标签页打开）
• 官方团队角色和 Billing（在新标签页打开）
• 官方 Usage Dashboard 准入（在新标签页打开）

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。