API 文档v0.9.11 Base URL https://jusouai.cnBearer 鉴权1–4 积分/次,Exa 部分参数另加 MarkdownOpenAPISKILL.md
开发文档 / 引擎 / Brave
B

Brave

独立索引的海外网页搜索,另有为 AI 预提取的网页正文上下文,可直接喂给大模型。

参数与官方写法一致2 积分/次失败不扣分每次最多 10 条
我的 Key登录或兑换后,这里显示你的 Key,代码里自动填好去兑换登录控制台
1复制 Key没有就先兑换卡密,自动开户
2换个地址请求发到 https://jusouai.cn/v1/brave/web/search,参数照官方写法
3看扣分返回里 billing.summary 一句话说清本次扣分和剩余积分

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 的地址,复制就能跑。

POST /v1/brave/llm/context
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}'

参数

参数名和官方完全一样,原来的代码不用改。最常用的放前面。

参数说明必填例子
qstring问题或搜索词(≤ 600 字符、≤ 75 个词)例:how deep is the mediterranean sea必填how deep is the mediterranean sea
maximum_number_of_urlsinteger最多返回几个网址的正文 1-10(最多 10 条),默认 10例:5可选5
maximum_number_of_tokensinteger正文总长度上限(约 token)1024-32768,默认 8192例:8192可选8192
countrystring结果来源国家,两位代码如 US / JP / CN,或 ALL;默认 US例:US可选US
search_langstring结果语言,如 en / zh-hans;默认 en例:en可选en
freshnessstringpd / 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_number_of_tokens_per_urlinteger每个网址正文上限 512-8192,默认 4096例:4096可选4096
context_threshold_modestring相关度门槛:disabled / strict / lenient / balanced例:balanced可选balanced
safesearchstringoff / moderate / strict例:moderate可选moderate
spellcheckboolean是否拼写纠正,默认 true例:false可选false
operatorsboolean是否启用 site: 等搜索语法,默认 true例:true可选true
operators_fallbackboolean搜索语法无结果时回退到原始结果,默认 true例:true可选true
gogglesstring自定义重排规则,最多 3 个(可传数组)例:https://…/my.goggle可选https://…/my.goggle
enable_localboolean地点类问题返回地点信息(poi / map)例:true可选true
enable_source_metadatabooleansources 里附带站点名、图标、描述等例:true可选true
不支持:summary、enable_rich_callback、goggles_id;maximum_number_of_urls 最多 10。传了会返回 400,不扣分。

返回

结构和官方一致,另外多一个 billing(本次扣分、剩余积分、一句话说明)。

响应 200
{
  "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 换一家,本次未扣积分

价格

2 积分/次
轻量卡 1000 积分 ≈ 500 次
失败都不扣。积分所有引擎通用,一张卡密什么引擎都能用。
接口档位触发条件积分/次
/v1/brave/web/search 网页搜索standard 默认任意参数2
/v1/brave/llm/context 正文上下文standard 默认任意参数2
想同时用几家? 用统一接口 /v1/search,一次请求对比 Brave、Exa、SerpApi 的结果 →