Tavily 搜索多少钱：免费额度与付费价格对照

阿橘 技术创作者 2026-11-04 75 阅读

Tavily 是面向 AI Agent 的联网搜索 API，可按调用次数和搜索深度消耗额度。截至 2026 年 10 月 30 日，Tavily 更新了 Credits & Pricing 文档，免费档仍提供每月 1,000 API Credits；现在正值价格与套餐口径重新核对，开发者可据此先选套餐，再申请密钥并验证扣费。

API Credit 是 Tavily 对一次 API 操作使用的计费单位；Basic Search 消耗 1 个额度，Advanced Search 消耗 2 个额度。不同接口、不同搜索深度不会统一按“一次请求一个额度”计算。

免费、套餐与按量付费怎么选

Tavily 官方目前同时提供免费档、固定月套餐和按量付费。下表价格与额度来自官方 Credits & Pricing 及 Pricing 页面：

方案 月度价格 每月额度 更适合谁
Researcher 免费档 $0 1,000 Credits 个人试用、低频查询
Project $30 4,000 Credits 需要更高频率的独立开发者
Bootstrap $100 15,000 Credits 小型团队
Startup $220 38,000 Credits 用量持续增长的应用
Growth $500 100,000 Credits 已有稳定生产流量
Pay-as-You-Go $0.008/Credit 按实际使用量 用量不固定或希望随时停用月套餐

固定月套餐的官方价格区间为每额度 $0.0075 至 $0.005；超过套餐包含的额度后，可启用按量付费，单额度价格为 $0.008。Enterprise 企业方案不公开统一报价，需要单独询价。

选择时先看调用频率，再看是否需要更高请求速率。免费档无需信用卡，适合先跑通接入；若每月稳定超过 1,000 Credits，Project 是最低成本的固定套餐入口。调用量起伏较大时，Pay-as-You-Go 更容易控制，但按量单价高于月套餐区间。

开通账号并取得 API Key

  1. 打开 Tavily 控制台，注册或登录账号。
  2. 进入 Get an API key 页面，领取 API Key；免费档不要求绑定信用卡。
  3. 复制以 tvly- 开头的密钥，保存到密码管理器或环境变量中，不要提交到 Git 仓库。

如只想临时调用 Search 或 Extract，官方文档还提供 keyless access，即不申请 API Key 也能发起这两类调用；后续使用 SDK、接口 Playground 或持续集成时，再创建正式 Key 更方便。

设置环境变量的方式可以采用：

export TAVILY_API_KEY="tvly-YOUR_API_KEY"

这里的 tvly-YOUR_API_KEY 是官方示例占位符，需要替换成控制台生成的真实密钥。

用一次请求验证价格与接入

先安装任一官方 SDK。下面两条安装命令分别适用于 Python 和 JavaScript：

pip install tavily-python
npm i @tavily/core

Python 调用方式如下：

from tavily import TavilyClient

tavily_client = TavilyClient(api_key="tvly-YOUR_API_KEY")
response = tavily_client.search("Who is Leo Messi?")
print(response)

JavaScript 调用方式如下：

const { tavily } = require("@tavily/core");

const tvly = tavily({ apiKey: "tvly-YOUR_API_KEY" });
const response = await tvly.search("Who is Leo Messi?");
console.log(response);

不装 SDK 时，可以直接调用官方 cURL 示例：

curl -X POST https://api.tavily.com/search 
-H "Content-Type: application/json" 
-H "Authorization: Bearer tvly-YOUR_API_KEY" 
-d '{"query":"Who is Leo Messi?"}'

代码运行后出现搜索结果对象，说明 Key、请求地址和账户额度都已生效。再回到控制台的额度页面核对本月剩余 Credits：如果 Free 档从 1,000 减少 1 个额度，本次就是 Basic Search；如果减少 2 个额度，则对应 Advanced Search。

按搜索深度估算实际调用成本

Basic Search 每次消耗 1 Credit，Advanced Search 每次消耗 2 Credits。假设应用只调用 Basic Search，100,000 次查询需要 100,000 Credits；换成 Advanced Search，同样查询次数会消耗 200,000 Credits。这个对比说明，不能只统计请求数，还要确认代码里的 search_depth 配置。

调用方式 每 1,000 次查询消耗 按 $0.008/Credit 计算的额度费用
Basic Search 1,000 Credits $8
Advanced Search 2,000 Credits $16

上表费用按官方按量单价复算，不包含固定月套餐已包含的额度。它适合比较不同搜索深度的消耗，不应直接当作所有接入方式的最终账单；月度固定方案应先扣除套餐内额度，再判断超额部分。

Advanced Search 是否必要，取决于结果质量要求。若调用方只需为普通问题补充几个网页来源，Basic Search 通常更省；若结果质量直接决定 Agent 的后续判断，再针对关键查询启用 Advanced Search，比把所有请求统一升级更划算。

在 Claude Code、Codex 和 Cursor 中接入

如果 Tavily 主要给编码 Agent 提供联网能力，可以走 MCP，不必先改业务代码。

Claude Code 使用官方给出的命令：

claude mcp add tavily --transport http https://mcp.tavily.com/mcp/

Codex 使用：

codex mcp add tavily --url https://mcp.tavily.com/mcp/
codex mcp login tavily

执行后启动新会话，客户端会打开浏览器，要求登录并授权 Tavily。Cursor 用户可在 Tavily 文档的 Integrations 页面选择 Cursor，按提示登录；也可在 ~/.cursor/mcp.json 中加入官方提供的 MCP 配置。

MCP 配置示例：

"mcpServers": {
  "tavily": {
    "url": "https://mcp.tavily.com/mcp/"
  }
}

这条 JSON 是配置文件片段，不能单独作为完整文件覆盖原有配置；应把 mcpServers 下的 tavily 项合并进现有 mcp.json。

两个容易卡住的环节

搜索词被安全策略拦截。 Tavily 官网示例中出现过这一原文错误：

Query blocked, PII detected with type: EMAIL

这表示查询中包含被识别为个人信息的邮箱地址。可执行的改法是移除邮箱等个人信息，改用不含个人数据的关键词重新搜索，例如把 hello@company.com 改成 company official website。若业务必须处理该邮箱，应在发送至 Tavily 前先删除或脱敏，而不是反复重试原请求。

MCP 已添加但无法调用。 在 Codex 中只执行 codex mcp add tavily --url https://mcp.tavily.com/mcp/ 还不够，还要执行：

codex mcp login tavily

随后启动新会话完成浏览器授权。Claude Code 则需要重新开启一次会话，让客户端触发登录流程。连接失败时先确认使用的是 https://mcp.tavily.com/mcp/，不要把 API Key 直接写进公开的 MCP 配置文件。

怎么确认已经开通成功

满足以下三个可观察结果，才算完成接入：

  • 控制台的 Get an API key 页面显示已生成密钥，套餐额度与所选方案一致。
  • Python、JavaScript 或 cURL 请求返回搜索结果对象，而不是停留在安装或登录页面。
  • 额度页面显示本月 Credits 已按请求扣减；Basic Search 每次减少 1 个额度，Advanced Search 每次减少 2 个额度。

如果只需要低频人工测试，先使用免费档或 keyless access；准备接入生产 Agent 后，再根据连续几个月的调用量选择 Project、Bootstrap、Startup、Growth，或保留按量付费。

官方入口与继续核对的位置

参考来源

# AI# 知识

评论区

0 条评论

登录后可评论。

阿橘 75 阅读