Brave
独立索引的海外网页搜索,另有为 AI 预提取的网页正文上下文,可直接喂给大模型。
https://jusouai.cn/v1/brave/web/search,参数照官方写法billing.summary 一句话说清本次扣分和剩余积分POST /v1/brave/web/searchBrave 网页搜索
与 Brave 官方 web/search 参数同名、返回结构一致(官方是 GET 查询参数,这里放进 JSON 请求体)。返回 web.results(title / url / description 等),按需还有 news / videos / discussions。
官方地址 https://api.search.brave.com/res/v1/web/search → 换成 https://jusouai.cn/v1/brave/web/search,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。
第一次调用
已帮你填好 Key 和 Brave 的地址,复制就能跑。
curl https://jusouai.cn/v1/brave/web/search \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"q": "solid-state battery mass production 2026", "count": 5, "country": "US"}'import requests
r = requests.post(
"https://jusouai.cn/v1/brave/web/search",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "solid-state battery mass production 2026",
"count": 5,
"country": "US"
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/brave/web/search", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "solid-state battery mass production 2026",
"count": 5,
"country": "US"
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Brave 网页搜索」接口:
- 地址:POST https://jusouai.cn/v1/brave/web/search
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Brave 官方写法一致。必填:q;常用:q, count, country, search_lang, freshness, offset
- 例子:{"q": "solid-state battery mass production 2026", "count": 5, "country": "US"}
- 返回:结构与 Brave 官方一致(type, query, web),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/brave参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
qstring | 搜索词(≤ 600 字符、≤ 75 个词)例:solid-state battery 2026 | 必填 | solid-state battery 2026 |
countinteger | 返回条数 1-10(最多 10 条),默认 10例:5 | 可选 | 5 |
countrystring | 结果来源国家,两位代码如 US / JP / CN,或 ALL;默认 US例:US / JP / CN | 可选 | US / JP / CN |
search_string | 结果语言,如 en / zh-hans / zh-hant / ja;默认 en例:en / zh-hans | 可选 | en / zh-hans |
freshnessstring | pd(24 小时)/ pw(7 天)/ pm(31 天)/ py(一年),或 2026-01-01to2026-06-30例:pw(7 天) | 可选 | pw(7 天) |
offsetinteger | 翻页:跳过几页(每页 count 条),0-9例:1 = 第 2 页 | 可选 | 1 = 第 2 页 |
展开其余 10 个参数(ui_lang、safesearch、spellcheck、text_decorations、result_filter、units、goggles、extra_snippets、operators、include_fetch_metadata)
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
ui_string | 返回界面语言,如 en-US / zh-CN例:zh-CN | 可选 | zh-CN |
safesearchstring | off / moderate(默认)/ strict例:strict | 可选 | strict |
spellcheckboolean | 是否拼写纠正,默认 true例:false | 可选 | false |
text_boolean | 摘要里是否带高亮标记,默认 true例:false | 可选 | false |
result_string | 只要这些类型,逗号分隔:web / news / videos / discussions / faq / infobox / query / locations例:web,news | 可选 | web,news |
unitsstring | metric / imperial例:metric | 可选 | metric |
gogglesstring | 自定义重排规则(Goggle 地址或定义),最多 3 个(可传数组)例:https://…/my.goggle | 可选 | https://…/my.goggle |
extra_boolean | 每条最多再附 5 段摘录例:true | 可选 | true |
operatorsboolean | 是否启用 site: 等搜索语法,默认 true例:true | 可选 | true |
include_boolean | 附带抓取时间等元数据例:true | 可选 | true |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"type": "search",
"query": {
"original": "…"
},
"web": {
"type": "search",
"results": [
{
"title": "…",
"url": "https://example.com/a",
"description": "…",
"page_age": "2026-10-01T08:00:00",
"extra_snippets": [
"…"
]
}
]
},
"billing": {
"points": 2,
"balance": 998,
"summary": "本次:Brave -2 积分,剩余 998"
}
}POST /v1/brave/llm/contextBrave 正文上下文(给 AI)
与 Brave 官方 llm/context 参数同名、返回结构一致:搜索后直接给出每个网页里与问题相关的正文片段,适合 RAG / Agent 直接引用。默认最多 10 个网址。
官方地址 https://api.search.brave.com/res/v1/llm/context → 换成 https://jusouai.cn/v1/brave/llm/context,Key 换成 聚搜GO 的 Key(推荐请求头 Authorization: Bearer <Key>;官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key 写法也直接可用),请求体不用改。
第一次调用
已帮你填好 Key 和 Brave 的地址,复制就能跑。
curl https://jusouai.cn/v1/brave/llm/context \
-H "Authorization: Bearer jsk_你的Key" \
-H "Content-Type: application/json" \
-d '{"q": "how deep is the mediterranean sea", "maximum_number_of_urls": 5}'import requests
r = requests.post(
"https://jusouai.cn/v1/brave/llm/context",
headers={"Authorization": "Bearer jsk_你的Key"},
json={
"q": "how deep is the mediterranean sea",
"maximum_number_of_urls": 5
},
timeout=60,
)
data = r.json()
print(data["billing"]["summary"]) # 本次扣分与剩余积分
print(data)const r = await fetch("https://jusouai.cn/v1/brave/llm/context", {
method: "POST",
headers: {
"Authorization": "Bearer jsk_你的Key",
"Content-Type": "application/json"
},
body: JSON.stringify({
"q": "how deep is the mediterranean sea",
"maximum_number_of_urls": 5
})
});
const data = await r.json();
console.log(data.billing.summary); // 本次扣分与剩余积分
console.log(data);请帮我调用 聚搜GO 的「Brave 正文上下文(给 AI)」接口:
- 地址:POST https://jusouai.cn/v1/brave/llm/context
- 请求头:Authorization: Bearer jsk_你的Key;Content-Type: application/json
- 请求体:JSON,参数名与 Brave 官方写法一致。必填:q;常用:q, maximum_number_of_urls, maximum_number_of_tokens, country, search_lang, freshness
- 例子:{"q": "how deep is the mediterranean sea", "maximum_number_of_urls": 5}
- 返回:结构与 Brave 官方一致(grounding, sources),另有 billing.summary 写明本次扣分与剩余积分
- 出错时看 error.message 与 error.hint(怎么办);失败不扣分
- 完整参数:https://jusouai.cn/docs/brave参数
参数名和官方完全一样,原来的代码不用改。最常用的放前面。
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
qstring | 问题或搜索词(≤ 600 字符、≤ 75 个词)例:how deep is the mediterranean sea | 必填 | how deep is the mediterranean sea |
maximum_integer | 最多返回几个网址的正文 1-10(最多 10 条),默认 10例:5 | 可选 | 5 |
maximum_integer | 正文总长度上限(约 token)1024-32768,默认 8192例:8192 | 可选 | 8192 |
countrystring | 结果来源国家,两位代码如 US / JP / CN,或 ALL;默认 US例:US | 可选 | US |
search_string | 结果语言,如 en / zh-hans;默认 en例:en | 可选 | en |
freshnessstring | pd / pw / pm / py,或 2026-01-01to2026-06-30例:pm(31 天) | 可选 | pm(31 天) |
展开其余 10 个参数(count、maximum_number_of_tokens_per_url、context_threshold_mode、safesearch、spellcheck、operators、operators_fallback、goggles、enable_local、enable_source_metadata)
| 参数 | 说明 | 必填 | 例子 |
|---|---|---|---|
countinteger | 参与挑选正文的搜索结果数 1-50,默认 20例:20 | 可选 | 20 |
maximum_integer | 每个网址正文上限 512-8192,默认 4096例:4096 | 可选 | 4096 |
context_string | 相关度门槛:disabled / strict / lenient / balanced例:balanced | 可选 | balanced |
safesearchstring | off / moderate / strict例:moderate | 可选 | moderate |
spellcheckboolean | 是否拼写纠正,默认 true例:false | 可选 | false |
operatorsboolean | 是否启用 site: 等搜索语法,默认 true例:true | 可选 | true |
operators_boolean | 搜索语法无结果时回退到原始结果,默认 true例:true | 可选 | true |
gogglesstring | 自定义重排规则,最多 3 个(可传数组)例:https://…/my.goggle | 可选 | https://…/my.goggle |
enable_boolean | 地点类问题返回地点信息(poi / map)例:true | 可选 | true |
enable_boolean | sources 里附带站点名、图标、描述等例:true | 可选 | true |
返回
结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。
{
"grounding": {
"generic": [
{
"url": "https://example.com/a",
"title": "…",
"snippets": [
"…",
"…"
]
}
]
},
"sources": {
"https://example.com/a": {
"title": "…",
"hostname": "example.com"
}
},
"billing": {
"points": 2,
"balance": 998,
"summary": "本次:Brave -2 积分,剩余 998"
}
}出错怎么办
错误响应里的 error.hint 就是下面这句「怎么办」。所有失败都不扣分。
| 错误 | 怎么办(error.hint) |
|---|---|
401 Key 不对 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
402 积分不够 | 兑换新的卡密续费,同一个 Key 自动叠加;本次未扣积分 |
400 参数不对 | 看 message 里说的是哪个参数,改好再试;本次未扣积分 |
429 太快了 | 稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐 |
503 暂不可用 | 稍后再试,或用 engine 换一家已开放的引擎;本次未扣积分 |
502 引擎异常 | 稍后重试(已自动重试过);着急可用 engine 换一家,本次未扣积分 |
价格
| 接口 | 档位 | 触发条件 | 积分/次 |
|---|---|---|---|
/v1/brave/web/search 网页搜索 | standard 默认 | 任意参数 | 2 |
/v1/brave/llm/context 正文上下文 | standard 默认 | 任意参数 | 2 |