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

余额与流水

兑换卡密、查余额、看调用流水与按引擎扣分明细;以及计费口径和全部价目。这些接口都不扣分。

计费口径

  • 一份积分,所有引擎通用:任何套餐的积分都能调所有已开放引擎,不按引擎划分;只是不同引擎、档位每次扣分不同。
  • 按调用次数扣固定积分,一次一价:当前 1–4 积分/次;每次扣多少由「接口 · 档位」决定(见下方价目);少数参数另有加价(如 Exa 超过 10 条、summary,价目里写作 +N),与档位积分相加,调用前一次算清,不会事后补扣。
  • 档位由请求参数决定(如某个参数取某个值),对照价目里的「触发条件」;没写到的取值按该操作的默认档计。
  • 调用成功(含结果为空)照价目扣分;参数错误、引擎故障、超时、繁忙、暂不可用都不扣分。
  • 每次响应头带 x-request-id、x-points-charged(本次扣分,未扣为 0)和 x-points-tier(本次计费档位)。
  • 控制台「按引擎扣分明细」可看今日 / 近 7 天 / 近 30 天各引擎的调用次数与扣分;GET /v1/usage/summary 同口径。
  • 季卡 / 年卡按月到账:每月一份积分(数量同对应月卡),当月有效,下次到账时清零,不累积;兑换当天发放第 1 个月,之后每满一个月发下一份(季卡连续 3 个月、年卡连续 12 个月)。可与其他卡叠加,扣分先用最早到期的。
  • 每次调用的返回里都有 billing:points 本次扣分、balance 剩余积分、summary 一句话(如「本次:Exa -2 积分,剩余 998」)。

套餐

购买与兑换见首页套餐。

套餐月付季付年付
轻量卡¥19 · 1,000 积分 · 30 天¥51(折合 ¥17/月,省 11%)· 每月 1,000 积分¥194(折合 ¥16.2/月,省 15%)· 每月 1,000 积分
标准卡¥49 · 3,000 积分 · 30 天¥132(折合 ¥44/月,省 10%)· 每月 3,000 积分¥500(折合 ¥41.7/月,省 15%)· 每月 3,000 积分
旗舰卡¥199 · 15,000 积分 · 30 天¥537(折合 ¥179/月,省 10%)· 每月 15,000 积分¥2,030(折合 ¥169.2/月,省 15%)· 每月 15,000 积分

控制台登录

  • 开通账户有两种方式,可以并用:直接输入卡密(没有账户会自动开户、生成 API Key 并登录,无需注册);或在控制台「注册」用邮箱注册(邮箱 6 位验证码 + 设置密码,至少 8 位),注册即开户并生成 API Key、自动登录,账户初始 0 积分,之后在控制台输入卡密兑换积分(0 积分时调用搜索接口返回余额不足 402)。
  • 一个邮箱只能注册一个账户:已注册(或已被某个账户绑定)的邮箱会提示「该邮箱已注册,请登录或找回密码」。卡密开户的账户之后也可以在控制台「绑定邮箱」并设置密码;已登录时兑换的卡密积分进当前账户。
  • 控制台(/console)有两种登录方式:邮箱 + 密码 登录和 密钥登录(粘贴 API Key)。
  • 邮箱 + 密码:先在控制台「绑定邮箱」(6 位验证码),再点「设置密码」(验证码发到绑定邮箱,密码至少 8 位)。改密码需要当前密码,忘了也可以改用邮箱验证码;改密后其它设备上的登录会退出。没绑定邮箱的账户只能用密钥登录。
  • 忘记密码:登录页「邮箱登录」→「忘记密码?」,输入绑定的邮箱,收一条重置链接(30 分钟内有效、只能用一次);重置后其它设备上的登录全部退出,API Key 不变。
  • 一个邮箱绑了多个账户时,密码按账户分别设置;登录时匹配到哪个账户就进哪个,多个账户用了同一个密码会让你选择账户。
  • 同一网络对同一邮箱连续输错 5 次密码会锁定 10 分钟;密钥丢了也可以用「密钥登录」下的邮箱找回(一次性登录链接)。
  • API 调用始终用 API Key 鉴权;密码只用于登录控制台,不能代替 Key 调接口。
POST/v1/redeem

兑换卡密#

不带密钥时:兑换并开户,返回 api_key(登录控制台后可随时查看 / 复制,忘了或泄露可在控制台重置)。带密钥时:兑换到当前账户。

鉴权
无需
计费
免费

请求体

codestring必填
兑换码,形如 JS-LM-XXXX-XXXX(JS 后一段是代号:L 轻量 / S 标准 / F 旗舰,M 月 / Q 季 / Y 年;更早的老卡 JS-XXXX-XXXX-XXXX 同样可用)

错误

错误什么时候怎么办(error.hint)
400
invalid_code
兑换码无效或已被使用核对卡密是否抄错、是否已兑换过;仍不行请联系购买处
429
rate_limited
超过套餐每秒请求数(排队超过上限)稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐
POST /v1/redeem
curl https://jusouai.cn/v1/redeem \
  -H "Content-Type: application/json" \
  -d '{"code": "JS-LM-ABCD-EFGH"}'
响应 200
{
  "customer_id": 1,
  "plan": "轻量卡",
  "points": 1000,
  "daily_points": null,
  "ends_at": "2026-11-30 12:00:00",
  "api_key": "jsk_…",
  "notice": "这是你的 API Key:登录控制台后可随时查看 / 复制。Key 也是控制台登录凭证,请妥善保存、不要外传;忘了或泄露可在控制台重置(旧 Key 立即失效)。"
}
GET/v1/me

余额与权益#

total = 可用积分合计;entitlements 列出每项权益及到期时间。

鉴权
Bearer 密钥
计费
免费

查询参数

无请求参数。

错误

错误什么时候怎么办(error.hint)
401
unauthorized
缺少密钥或密钥无效检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制
GET /v1/me
curl https://jusouai.cn/v1/me \
  -H "Authorization: Bearer $JUSOU_KEY"
响应 200
{
  "customer_id": 1,
  "balance": {
    "total": 93,
    "daily_left": 0,
    "pack_left": 93,
    "entitlements": [
      {
        "id": 1,
        "kind": "trial",
        "name": "轻量卡",
        "left": 93,
        "daily_points": null,
        "qps": 2,
        "ends_at": "2026-11-30 12:00:00"
      }
    ]
  },
  "qps": 2
}
GET/v1/engines

引擎目录#

当前开放(live)与即将上线(coming)的引擎、简介与接口路径;只有 live 的引擎可以调用。

鉴权
无需
计费
免费

查询参数

无请求参数。

错误

无业务错误(服务异常时返回 500 internal_error)。

GET /v1/engines
curl https://jusouai.cn/v1/engines
响应 200
{
  "engines": [
    {
      "name": "exa",
      "label": "Exa",
      "status": "live",
      "category": "网页搜索",
      "paths": [
        "/v1/exa/search"
      ]
    }
  ]
}
GET/v1/usage

调用流水#

最近的调用,每条带引擎 / 操作 / 档位 / 本次扣分(points,未扣为 0)。可按引擎、时间筛选。

鉴权
Bearer 密钥
计费
免费

查询参数

limitinteger可选
条数,1-500,默认 50(查询参数)
enginestring可选
只看这个引擎(查询参数)
periodstring可选
today / 7d / 30d,不填为全部(查询参数)

错误

错误什么时候怎么办(error.hint)
401
unauthorized
缺少密钥或密钥无效检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制
GET /v1/usage
curl https://jusouai.cn/v1/usage \
  -H "Authorization: Bearer $JUSOU_KEY"
响应 200
{
  "items": [
    {
      "request_id": "js-…",
      "engine": "exa",
      "operation": "search",
      "tier": "standard",
      "points": 1,
      "outcome": "ok",
      "result": "成功",
      "created_at": "2026-10-31 12:00:00"
    }
  ]
}
GET/v1/usage/summary

按引擎扣分明细#

某段时间内各引擎的调用次数、扣分次数、扣分合计,以及按操作 · 档位的细分。

鉴权
Bearer 密钥
计费
免费

查询参数

periodstring可选
today(默认)/ 7d / 30d(查询参数,北京时间按天算)

错误

错误什么时候怎么办(error.hint)
401
unauthorized
缺少密钥或密钥无效检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制
GET /v1/usage/summary
curl https://jusouai.cn/v1/usage/summary \
  -H "Authorization: Bearer $JUSOU_KEY"
响应 200
{
  "period": "7d",
  "since": "2026-10-25 00:00:00",
  "engines": [
    {
      "engine": "exa",
      "label": "Exa",
      "calls": 12,
      "charged_calls": 11,
      "points": 11,
      "tiers": [
        {
          "operation": "search",
          "tier": "standard",
          "calls": 12,
          "charged_calls": 11,
          "points": 11
        }
      ]
    }
  ],
  "total": {
    "calls": 12,
    "charged_calls": 11,
    "points": 11
  }
}
GET/v1/pricing

价目表#

每个引擎每个操作 · 档位每次调用的固定积分(含触发条件),以及在售套餐(calls_est = 约可调用基础搜索次数)。每张套餐的 terms 列出月付 / 季付 / 年付:price_fen 售价、per_month_fen 折合每月、save_pct 比按月买省的百分比、monthly_points 每月到账积分(季 / 年卡按月到账:每月一份,当月有效,下次到账时清零)。一份积分所有引擎通用。

鉴权
无需
计费
免费

查询参数

无请求参数。

错误

无业务错误(服务异常时返回 500 internal_error)。

GET /v1/pricing
curl https://jusouai.cn/v1/pricing
响应 200
{
  "engines": [
    "exa",
    "serpapi",
    "tavily",
    "serper",
    "anysearch",
    "brave",
    "bocha",
    "baidu"
  ],
  "base_points": 1,
  "rules": [
    {
      "engine": "exa",
      "operation": "search",
      "tier": "standard",
      "points": 1,
      "condition": "任意参数",
      "is_default": 1
    }
  ],
  "groups": [
    {
      "engine": "exa",
      "label": "Exa",
      "operations": [
        {
          "operation": "search",
          "label": "搜索",
          "method": "POST",
          "path": "/v1/exa/search",
          "tiers": [
            {
              "tier": "standard",
              "condition": "任意参数",
              "points": 1,
              "default": true
            }
          ]
        }
      ]
    }
  ],
  "plans": [
    {
      "id": 5,
      "kind": "trial",
      "name": "轻量卡",
      "price_fen": 1900,
      "points": 1000,
      "days": 30,
      "qps": 2,
      "buy_url": "https://wzyp.cn/item/sl23u6",
      "calls_est": 1000,
      "terms": [
        {
          "term": "month",
          "label": "月付",
          "id": 5,
          "name": "轻量卡",
          "months": 1,
          "price_fen": 1900,
          "per_month_fen": 1900,
          "list_price_fen": 1900,
          "save_pct": 0,
          "monthly_points": 1000,
          "days": 30,
          "qps": 2,
          "calls_est_monthly": 1000
        },
        {
          "term": "quarter",
          "label": "季付",
          "id": 8,
          "name": "轻量季卡",
          "months": 3,
          "price_fen": 5100,
          "per_month_fen": 1700,
          "list_price_fen": 5700,
          "save_pct": 11,
          "monthly_points": 1000,
          "days": 90,
          "qps": 2,
          "calls_est_monthly": 1000
        },
        {
          "term": "year",
          "label": "年付",
          "id": 9,
          "name": "轻量年卡",
          "months": 12,
          "price_fen": 19400,
          "per_month_fen": 1617,
          "list_price_fen": 22800,
          "save_pct": 15,
          "monthly_points": 1000,
          "days": 365,
          "qps": 2,
          "calls_est_monthly": 1000
        }
      ]
    }
  ],
  "terms": [
    {
      "term": "month",
      "label": "月付",
      "months": 1,
      "save_pct_max": 0,
      "save_pct_min": 0
    },
    {
      "term": "quarter",
      "label": "季付",
      "months": 3,
      "save_pct_max": 11,
      "save_pct_min": 10
    },
    {
      "term": "year",
      "label": "年付",
      "months": 12,
      "save_pct_max": 15,
      "save_pct_min": 15
    }
  ]
}

价目

每次调用扣固定积分(当前 1–4 积分/次),读自实时价目表。

Exa(exa)

接口档位触发条件(参数取值)积分/次
POST /v1/exa/search 搜索litetype=lite1
POST /v1/exa/search 搜索auto 默认type=auto 或不填(默认档)2
POST /v1/exa/search 搜索deeptype=deep 或 deep-lite4
POST /v1/exa/search 搜索extra10numResults 11–100:超过 10 条的部分每 10 条(不足 10 条按 10 条)加收,与档位积分相加+3 / 每 10 条
POST /v1/exa/search 搜索summarycontents 里要 summary(每条结果的摘要):加收,与档位积分、超条数加价相加+3
POST /v1/exa/answer 答案(含引用)standard 默认任意参数2

SerpApi(serpapi)

接口档位触发条件(参数取值)积分/次
POST /v1/serpapi/search Google 搜索standard 默认任意参数(没有结果不扣分)4

Tavily(tavily)

接口档位触发条件(参数取值)积分/次
POST /v1/tavily/search 搜索basic 默认search_depth=basic / fast 或不填(默认档)1
POST /v1/tavily/search 搜索advancedsearch_depth=advanced2

Serper(serper)

接口档位触发条件(参数取值)积分/次
POST /v1/serper/search 网页搜索standard 默认任意参数1
POST /v1/serper/images 图片搜索standard 默认任意参数1
POST /v1/serper/news 新闻搜索standard 默认任意参数1
POST /v1/serper/videos 视频搜索standard 默认任意参数1
POST /v1/serper/places 地点搜索standard 默认任意参数1
POST /v1/serper/shopping 购物搜索standard 默认任意参数2
POST /v1/serper/scholar 学术搜索standard 默认任意参数1

AnySearch(anysearch)

接口档位触发条件(参数取值)积分/次
POST /v1/anysearch/search 搜索standard 默认任意参数1

Brave(brave)

接口档位触发条件(参数取值)积分/次
POST /v1/brave/web/search 网页搜索standard 默认任意参数2
POST /v1/brave/llm/context 正文上下文standard 默认任意参数2

博查(bocha)

接口档位触发条件(参数取值)积分/次
POST /v1/bocha/web-search 网页搜索standard 默认任意参数1

百度(baidu)

接口档位触发条件(参数取值)积分/次
POST /v1/baidu/web-search 网页搜索standard 默认任意参数1
POST /v1/baidu/ai-search AI 搜索(生成答案)standard 默认任意参数(含 AI 答案)3