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

更新日志

0.9.6.12026-11-04
  • 兑换卡密成功后,如果账户还没绑定邮箱,首页和控制台会提示「建议绑定邮箱」:丢了 Key 可找回、可用邮箱 + 密码登录、收余额 / 到期提醒;可点「去绑定」,也可点「稍后」跳过。
0.9.62026-11-04
  • 新增邮箱注册:控制台「注册」用邮箱验证码 + 设置密码即可开通账户并生成 API Key(0 积分),之后输入卡密兑换积分。
  • 两种开户方式并存:直接输入卡密照旧自动开户;卡密开户后也可以在控制台绑定邮箱、设置密码,用邮箱 + 密码登录。
  • 控制台登录页改为「兑换卡密 / 登录 / 注册」;首页「我的账户」未开通时只显示开通 / 注册 / 登录引导。
0.9.52026-11-04
  • 控制台支持邮箱 + 密码登录:已绑定邮箱的账户可在控制台「绑定邮箱」里设置 / 修改登录密码,登录页新增「邮箱登录」,与「密钥登录」并列。
  • 忘记密码:在登录页输入绑定的邮箱,收一条重置链接(30 分钟内有效、只能用一次);重置后其它设备上的登录会退出,API Key 不变。
  • 没绑定邮箱的账户照旧用 API Key 登录;兑换卡密开户的流程不变。
0.9.4.42026-11-04
  • API Key 永久可见:登录控制台后随时「显示」/「复制」完整 Key(默认打码);Key 也是控制台登录凭证,请妥善保存,忘了或泄露可在控制台「重置密钥」,旧 Key 立即失效。
  • 绑定邮箱的验证码、邮箱找回的登录链接现在会真实发到你的邮箱;发送失败会直接提示,不会显示成已发送。
  • 控制台调用流水默认显示最近 10 条,「查看全部」可分页(每页 20 / 30 / 50)、按引擎和时间筛选,并可导出 CSV。
0.9.4.22026-11-03
  • Serper 购物搜索(POST /v1/serper/shopping)改为每次 2 积分(Serper 官方购物搜索每次计 2 次额度);Serper 其它类型(search / images / news / videos / places / scholar)仍每次 1 积分。
0.9.32026-11-03
  • 季卡 / 年卡说明更清楚:官网季付 / 年付写明「连续 N 个月,每月发放」与每月积分、当月有效、未用完下月清零、兑换当天发放第 1 个月。
  • 控制台兑换季卡 / 年卡前先确认:今天发多少、之后每月几号再发、连续几个月;余额区显示第几个月、本月剩余,以及哪天清零并到账下月。
0.9.22026-11-03
  • 鉴权直接接受官方 SDK 写法:x-api-key、X-Subscription-Token、查询参数 api_key,以及不带 Bearer 的 Authorization,与 Bearer 等价。
  • MCP 连接时就校验 Key:缺少或无效直接返回 401 并说明原因,不再先列出工具;web_search 工具新增 language 参数。
  • 400 / 401 / 404 错误响应也带 request_id;控制台「AI 调用」提示词里的 Key 打码显示,复制时仍是完整 Key。
0.9.1.12026-11-03
  • 鉴权报错更清楚:用官方 SDK 默认的 x-api-key / X-Subscription-Token / api_key,或 Authorization 没写 Bearer 时,401 直接说明要改成 Authorization: Bearer <Key>。engine=exa 时 num_results 超限的报错写明 1–100。
  • 文档与首页示例可直接复制运行;价目说明注明 Exa 部分参数另加。
0.9.02026-11-03
  • Exa numResults 放开到 1–100(统一接口与 MCP 的 num_results 对 Exa 同样放开):前 10 条含在档位积分里,超过 10 条后每多 10 条(不足 10 条按 10 条)加收积分,contents 要 summary 另加收,都与档位积分相加;超过 100 返回 400,不扣分。其它引擎仍最多 10 条。
0.8.92026-11-03
  • 套餐新增季付 / 年付:首页套餐区可切换月付 / 季付 / 年付;季卡 3 个月、年卡 12 个月,每月到账一份积分(数量同月卡),从兑换日起每满一个月到账下一份,当月没用完的在下次到账时清零。/v1/pricing 每张套餐新增 terms。
0.8.72026-11-03
  • 新增 Serper:Google 搜索结果,速度快。原生接口 POST /v1/serper/{search|images|news|videos|places|shopping|scholar},参数与返回与 Serper 官方一致(q / gl / hl / num / page / location / tbs);统一接口与 MCP 用 engine=serper。
0.8.62026-11-03
  • Google 搜索引擎改名为 SerpApi(engine=serpapi):参数与返回与 SerpApi 官方 Google Search API 一致,原生接口改为 POST /v1/serpapi/search(engine=google 可不传),统一接口与 MCP 用 engine=serpapi。
0.8.42026-11-02
  • 开发文档按引擎分页:先选你要用的引擎,每家一页(参数与官方写法一致、我的 Key、第一次调用、参数速查、返回示例、出错怎么办、价格);统一接口页新增各家参数支持对照表与 depth 含义。
  • 每次调用的返回里新增 billing:points(本次扣分)、balance(剩余积分)、summary(一句话,如「本次:-2 积分,剩余 998」);原生接口的官方字段不变。
  • 错误响应新增 error.hint:一句话告诉你怎么办。
  • GET /v1/engines 每个引擎新增 capabilities:支持的公共参数、depth 档位及含义与扣分。
0.8.32026-11-02
  • 新增 Google 搜索(0.8.6 起名为 SerpApi):参数 q / num / start / hl / gl / location / tbs 等,返回 organic_results,另有精选摘要、知识面板、相关问题。
  • Google 搜索没有结果时不扣积分;num 最多 10。
  • Brave 正式开放(见 0.8.2)。
0.8.22026-11-02
  • 新增 Brave:网页搜索 POST /v1/brave/web/search,以及给 AI 的正文上下文 POST /v1/brave/llm/context(直接返回网页里与问题相关的正文片段);统一接口 depth=basic 走网页搜索,depth=advanced 走正文上下文。
0.8.12026-11-02
  • 首页与价格页的套餐卡可直接点击购买。
  • 控制台与首页「我的账户」显示绑定邮箱、持有的套餐(积分 / 剩余 / 到期)、可用积分合计与最近到期。
  • 余额提醒:积分低于设定比例或数量、权益到期前若干天,发邮件到绑定邮箱(每种提醒同一阈值只发一次,续费后重新计)。
0.8.02026-11-02
  • 统一接口与 MCP 的 engine 可省略:不指定时用默认引擎,响应的 engine 字段与响应头 x-engine 写明实际引擎;失败不会自动换别家。
  • num_results 上限统一为 10(统一接口、MCP 与各引擎)。
  • Exa 档位精简为 lite / auto / deep 与 answer,numResults 最多 10;Tavily fast 与 basic 同档,max_results 最多 10。
  • 统一接口 Exa 的 snippet 改为精选片段(highlights),content 只放正文。
  • 新增 OpenAPI 3.1 描述 /openapi.json;SKILL.md 精简。
0.7.02026-11-02
  • Exa、Tavily 开放(原生兼容接口与统一接口)。
  • 远程 MCP /mcp:web_search / list_engines / get_balance。
0.6.02026-11-02
  • 统一接口支持 engines 多引擎同时搜,merge=true 去重合并。
0.5.02026-10-31
  • 按次扣固定积分,价目按「接口 · 档位」公开;一份积分所有引擎通用。

OpenAPI

机器可读的接口描述(OpenAPI 3.1),由引擎目录自动生成,新引擎上线自动出现:https://jusouai.cn/openapi.json。