Tavily 订阅怎么选：7 档套餐额度与 API Key 开通步骤

Tavily 是给 AI Agent 用的实时网页搜索 API，注册后即可拿 key 调用 /search、/extract 等端点。下面按官方帮助中心的七档套餐把额度、价格、开通路径和验证方法一次讲清。

先说清这件事管到哪一步

截至 2026 年 10 月 13 日第三方对 Tavily 平台做的实盘复核（数据在下方参考资料里注明来源），加上 Tavily 官网 2026 年版本的信息，这篇覆盖三件事：七档套餐分别给多少 API credits、怎么注册拿到 tvly- 开头的 key、拿 key 后用官方 SDK 跑通第一次搜索。定价页面上还挂着一句「Tavily is Joining Nebius」，说明它已进入大厂生态，这也是现在值得重新看一眼前价格与额度结构的原因。

先解释一个后面反复出现的词：API credit（API 额度点数）是 Tavily 的计费单位，搜索、抽取各消耗少量 credit，而 research（让 Agent 做多跳深度研究）一次可能吃掉几百个 credit——所以同一个额度下，能做几次普通搜索和几次 research，差别很大。

开通前只需要确认这三件事

1. 准备一个能收信的邮箱账号：打开 https://tavily.com ，点右上角 Log in 进入注册/登录页，用邮箱完成注册并验证。
2. 确认不需要绑卡：官方定价帮助中心写明 Free 档 No credit card required，第三方复核也确认免费档无需信用卡即可拿到 API key。
3. 确认运行环境：本地跑示例需要 Node.js（仓库为 TypeScript/JavaScript 库，MIT 许可），装好后运行 node -v 能打印版本号即可；不想装 Node 也可以直接用 HTTP 调用，但要自己准备请求头。

七档套餐：额度与价格对照

价格与额度数字全部出自官方帮助中心的 Pricing 页（https://help.tavily.com/articles/8816424538-pricing ），以下为截至该页抓取时的数据：

第七档是 Enterprise（需联系销售），官方定价页列出但未公开价格，适合有合规、私有化或大额用量需求的团队。

一个官方没写在表里的边界（这是我的推算，按上表 credit 数与第三方复核的 research 单次 4~250 credits 区间推的）：Free 档 1,000 credits 若全用于最贵的 research，最多只够 4 次；一次 250 credits 的 research 按 $0.008/credit 折算是 $2。而普通搜索单次只消耗少量 credit，所以免费档更适合「大量短搜索」而不是「深度研究」。

在动手开通前，先想清楚一个判断依据：按调用频次选档。如果只是让 Agent 偶尔查资料，Free 档 1,000 credits 足够验证链路；如果 Agent 每天要跑几十次 research，Project（$30/月、4,000 credits）或 Bootstrap（$100/月、15,000 credits）的单次成本更低；如果用量忽高忽低，Pay-As-You-Go（$0.008/credit）按实际调用计费，用完即停，不需要为峰值月买大档。Enterprise 档适合有合规、私有化或大额用量需求的团队，需联系销售获取报价。官方定价页列出 Enterprise 但未公开具体价格，通常这类档位会根据用量、合规要求和 SLA 条款定制报价。

三步开通并拿到 API Key

1. 注册并登录：在 https://tavily.com 点 Log in，用邮箱完成注册。
2. 进入控制台生成 key：登录后在 Dashboard 的 API Keys 区域新建一枚 key，复制保存，格式形如 tvly-YOUR_API_KEY（前缀 tvly- 来自官方 JS 仓库示例）。
3. 用 key 跑通一次调用：按下一节的代码验证。

同时记下后续要用的三个入口：API 文档在 https://docs.tavily.com ，各端点参考页分别是 https://docs.tavily.com/documentation/api-reference/endpoint/search 、https://docs.tavily.com/documentation/api-reference/endpoint/extract 、https://docs.tavily.com/documentation/api-reference/endpoint/research ；官方 SDK 仓库在 https://github.com/tavily-ai/tavily-js 。

两条验证路径：先 keyless，再带 key

官方 JavaScript SDK 支持两种模式。先跑 keyless（不要 key），因为它不需要账号：

npm i @tavily/core

const { tavily, TavilyKeylessLimitError } = require("@tavily/core");
// No apiKey — keyless mode
const tvly = tavily();
try {
  const response = await tvly.search("Who is Leo Messi?");
  console.log(response);
} catch (err) {
  if (err instanceof TavilyKeylessLimitError) {
    console.log("cap:", err.capType);
    console.log("retry after:", err.retryAfter);
    console.log("bonus eligible:", err.bonusEligible);
    console.log("continuation options:", err.continuationPaths);
  } else {
    throw err;
  }
}

keyless 模式下只有 search 与 extract 可用，且共用一个限流额度；其余方法会抛出「要求你提供 key」的错误。

再换成带 key 的正式用法（TAVILY_API_KEY 环境变量不设时会自动走 keyless）：

const { tavily } = require("@tavily/core");
// Step 1. Instantiating your Tavily client
const tvly = tavily({ apiKey: "tvly-YOUR_API_KEY" });
// Step 2. Executing a simple search query
const response = await tvly.search("Who is Leo Messi?");
console.log(response);

需要精确匹配人名或短语时，官方还给了 exactMatch: true 参数，只返回包含引号内原句的结果。

常见卡点与对应解法

卡点一：keyless 额度用尽。 报错形态是 SDK 抛出 TavilyKeylessLimitError，结构化字段里能看到 capType（触顶类型）、retryAfter（建议重试时间）、bonusEligible（是否可用额外额度）、continuationPaths（后续可选路径）。解法：按 retryAfter 退避重试；仍不通就去 https://tavily.com 注册拿 key，或直接开 Pay-As-You-Go。

卡点二：调 research 或其他非 search/extract 方法时提示需要 key。 解法：把 apiKey 显式传进 tavily({ apiKey: "tvly-..." })，或设置 TAVILY_API_KEY 环境变量后重启进程。

卡点三：免费档 research 请求被拒或限速。 第三方复核提到生产级 key 的 1,000 次/分钟需要付费套餐，因此「本地跑通但上线被拒」通常不是代码问题。解法：升级到付费档或改用 Pay-As-You-Go。

卡点四：请求被安全层拦截。 官网首页展示的请求示例里，返回体形如 "error": "Query blocked, PII detected with type: EMAIL"——Tavily 会阻断含 PII 的查询、提示注入与恶意来源。解法：把查询里的邮箱、身份证等个人信息去掉再重发，别想着绕。

配额用完后的处理： 免费档每月 1,000 credits 用完后，API 会返回 429 限流错误。此时可以等待下月重置，或直接升级到付费档。如果只是临时超出，也可以开 Pay-As-You-Go 按量计费，用完即停。

怎么算开通成功

三条可观察标志：控制台 API Keys 区域能看到自己那枚 tvly- key；带 key 的 tvly.search(...) 返回包含 results 的 JSON 而不是 error 对象；用 keyless 模式时若报限流，错误对象里 capType 字段有值，说明 SDK 与网络链路都已通。

规模上也可以侧面验证：官网给出的官方口径是每月处理 300M+ 请求、99.99% uptime SLA、/search 的 p50 延迟 180 ms、3M+ 开发者在用。

延伸入口

• 定价原文（本文表格来源）：https://help.tavily.com/articles/8816424538-pricing
• API 文档总入口：https://docs.tavily.com
• 官方 JS/TS SDK 与示例
• 官网与注册入口：https://tavily.com
• 企业检索基准数据集：https://huggingface.co/datasets/Tavily/tavily-company-search-benchmark
• 第三方实盘复核（credit 计费、research 单次消耗、限速说明等标注为「第三方复核」的事实出处）：https://theaiagentindex.com/agents/tavily

参考来源

• Tavily Review (2026): Web Search API for AI Agents
• Pricing