开发文档 / 引擎 / Tavily
T
Tavily 搜索
为智能体设计的搜索 API,结果干净、可直接喂给大模型。
1复制 Key没有就先兑换卡密,自动开户
2换个地址请求发到
https://jusouai.cn/v1/tavily/search,参数照官方写法3看扣分返回里
billing.summary 一句话说清本次扣分和剩余积分POST /v1/tavily/searchTavily 搜索
与 Tavily 官方 /search 一致:请求体、返回体原样,只把 request_id 换成我方的。档位按 search_depth 计。
官方地址 https://api.tavily.com/search → 换成 https://jusouai.cn/v1/tavily/search,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。
第一次调用
已帮你填好 Key 和 Tavily 的地址,复制就能跑。
POST /v1/tavily/search
curl https://jusouai.cn/v1/tavily/search \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"query": "2026 年固态电池量产进展", "search_depth": "basic", "max_results": 5, "include_answer": true}'import requests
r = requests.post(
"https://jusouai.cn/v1/tavily/search",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"query": "2026 年固态电池量产进展",
"search_depth": "basic",
"max_results": 5,
"include_answer": True
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/tavily/search", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"query": "2026 年固态电池量产进展",
"search_depth": "basic",
"max_results": 5,
"include_answer": true
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Tavily 搜索」接口:
- 地址:POST https://jusouai.cn/v1/tavily/search
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Tavily 官方写法一致。必填:query;常用:query, search_depth, max_results, topic, time_range, include_answer
- 例子:{"query": "2026 年固态电池量产进展", "search_depth": "basic", "max_results": 5, "include_answer": true}
- 返回:结构与 Tavily 官方一致(query, answer, images, request_id, results, response_time),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/tavily参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
querystring | 搜索词例:2026 年固态电池量产进展 | 必填 | 2026 年固态电池量产进展 |
search_string | basic(默认)/ fast / ultra-fast(与 basic 同价)/ advanced;advanced 进入高级档例:basic / advanced | 可选 | basic / advanced |
max_integer | 返回条数 0-10,默认 5例:5 | 可选 | 5 |
topicstring | general(默认)/ news / finance例:news | 可选 | news |
time_string | day / week / month / year例:week | 可选 | week |
include_boolean | 附带简短答案(也可传 basic / advanced)例:true | 可选 | true |
展开其余 18 个参数(start_date、end_date、days、chunks_per_source、include_raw_content、include_images、include_image_descriptions、include_favicon、include_domains、exclude_domains、country、exact_match、include_published_date、filter_by_published_date、include_domains_mode、language、filter_by_language、safe_search)
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
start_string | 起始日期 YYYY-MM-DD例:2026-01-01 | 可选 | 2026-01-01 |
end_string | 截止日期 YYYY-MM-DD例:2026-06-30 | 可选 | 2026-06-30 |
daysinteger | topic=news 时最近几天例:3 | 可选 | 3 |
chunks_integer | advanced 档每个来源返回几段,1-3例:3 | 可选 | 3 |
include_boolean | 附带网页正文(也可传 markdown / text)例:markdown | 可选 | markdown |
include_boolean | 附带图片例:true | 可选 | true |
include_boolean | 图片附说明例:true | 可选 | true |
include_boolean | 附带站点图标例:true | 可选 | true |
include_array | 只搜这些域名例:["reuters.com"] | 可选 | ["reuters.com"] |
exclude_array | 排除这些域名例:["reddit.com"] | 可选 | ["reddit.com"] |
countrystring | 优先某国结果,如 china(topic=general)例:china | 可选 | china |
exact_boolean | 只要精确包含引号短语的结果例:true | 可选 | true |
include_boolean | 每条结果带 published_date(topic=news 时自动开)例:— | 可选 | — |
filter_boolean | 去掉发布时间不在 time_range / start_date / end_date 内或无日期的结果例:— | 可选 | — |
include_string | restrict(默认,只要 include_domains)/ prefer(优先,不排除其它);需同时传 include_domains例:— | 可选 | — |
languagestring | 优先某语言结果,如 en / zh-cn例:— | 可选 | — |
filter_boolean | 严格只要 language 的结果(需同时传 language)例:— | 可选 | — |
safe_boolean | 过滤成人 / 不安全内容(fast / ultra-fast 不支持)例:— | 可选 | — |
不支持:auto_parameters(会让档位自动升高)、max_age_hours(强制实时抓取,高峰期常被拒),max_results 最多 10。传了会返回 400,不扣分。
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
响应 200
{
"query": "…",
"answer": "…",
"images": [],
"request_id": "js-20261031120000-a1b2c3d4e5f6",
"results": [
{
"title": "…",
"url": "https://example.com/a",
"content": "…",
"score": 0.81
}
],
"response_time": 1.2,
"billing": {
"points": 1,
"balance": 999,
"summary": "本次:Tavily -1 积分,剩余 999"
}
}出错怎么办
错误响应里的 error.hint 就是下面这句「怎么办」。所有失败都不扣分。
| 错误 | 怎么办(error.hint) |
|---|---|
401 Key 不对 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
402 积分不够 | 兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分 |
400 参数不对 | 看 message 里说的是哪个参数,改好再试;本次未扣积分 |
429 太快了 | 稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐 |
503 暂不可用 | 稍后再试,或用 engine 换一家已开放的引擎;本次未扣积分 |
502 引擎异常 | 稍后重试(已自动重试过);着急可用 engine 换一家,本次未扣积分 |
价格
1–2 积分/次
轻量卡 1000 积分 ≈ 1000 次(按最低档)
失败都不扣。积分所有引擎通用,一张卡密什么引擎都能用。
| 接口 | 档位 | 触发条件 | 积分/次 |
|---|---|---|---|
/v1/tavily/search 搜索 | basic(含 fast) 默认 | search_depth=basic / fast 或不填(默认档) | 1 |
/v1/tavily/search 搜索 | advanced | search_depth=advanced | 2 |