开发文档 / 通用参考
余额与流水
兑换卡密、查余额、看调用流水与按引擎扣分明细;以及计费口径和全部价目。这些接口都不扣分。
计费口径
- 一份积分,所有引擎通用:任何套餐的积分都能调所有已开放引擎,不按引擎划分;只是不同引擎、档位每次扣分不同。
- 按调用次数扣固定积分,一次一价:当前 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) |
|---|---|---|
400invalid_code | 兑换码无效或已被使用 | 核对卡密是否抄错、是否已兑换过;仍不行请联系购买处 |
429rate_limited | 超过套餐每秒请求数(排队超过上限) | 稍等 1–2 秒再试;需要更高并发可换每秒请求数更高的套餐 |
POST /v1/redeem
curl https://jusouai.cn/v1/redeem \
-H "Content-Type: application/json" \
-d '{"code": "JS-LM-ABCD-EFGH"}'import os
import requests
r = requests.post(
"https://jusouai.cn/v1/redeem",
headers={},
json={
"code": "JS-LM-ABCD-EFGH"
},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/redeem", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"code": "JS-LM-ABCD-EFGH"
})
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 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 列出每项权益及到期时间。
查询参数
无请求参数。
错误
| 错误 | 什么时候 | 怎么办(error.hint) |
|---|---|---|
401unauthorized | 缺少密钥或密钥无效 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
GET /v1/me
curl https://jusouai.cn/v1/me \
-H "Authorization: Bearer $JUSOU_KEY"import os
import requests
r = requests.get(
"https://jusouai.cn/v1/me",
headers={"Authorization": "Bearer " + os.environ["JUSOU_KEY"]},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/me", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.JUSOU_KEY}`
}
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 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/enginesimport os
import requests
r = requests.get(
"https://jusouai.cn/v1/engines",
headers={},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/engines", {
method: "GET"
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 200
{
"engines": [
{
"name": "exa",
"label": "Exa",
"status": "live",
"category": "网页搜索",
"paths": [
"/v1/exa/search"
]
}
]
}GET
/v1/usage调用流水#
最近的调用,每条带引擎 / 操作 / 档位 / 本次扣分(points,未扣为 0)。可按引擎、时间筛选。
查询参数
limitinteger可选条数,1-500,默认 50(查询参数)
enginestring可选只看这个引擎(查询参数)
periodstring可选today / 7d / 30d,不填为全部(查询参数)
错误
| 错误 | 什么时候 | 怎么办(error.hint) |
|---|---|---|
401unauthorized | 缺少密钥或密钥无效 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
GET /v1/usage
curl https://jusouai.cn/v1/usage \
-H "Authorization: Bearer $JUSOU_KEY"import os
import requests
r = requests.get(
"https://jusouai.cn/v1/usage",
headers={"Authorization": "Bearer " + os.environ["JUSOU_KEY"]},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/usage", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.JUSOU_KEY}`
}
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 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按引擎扣分明细#
某段时间内各引擎的调用次数、扣分次数、扣分合计,以及按操作 · 档位的细分。
查询参数
periodstring可选today(默认)/ 7d / 30d(查询参数,北京时间按天算)
错误
| 错误 | 什么时候 | 怎么办(error.hint) |
|---|---|---|
401unauthorized | 缺少密钥或密钥无效 | 检查请求头 Authorization: Bearer <Key>;Key 不对就回控制台重新复制 |
GET /v1/usage/summary
curl https://jusouai.cn/v1/usage/summary \
-H "Authorization: Bearer $JUSOU_KEY"import os
import requests
r = requests.get(
"https://jusouai.cn/v1/usage/summary",
headers={"Authorization": "Bearer " + os.environ["JUSOU_KEY"]},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/usage/summary", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.JUSOU_KEY}`
}
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 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/pricingimport os
import requests
r = requests.get(
"https://jusouai.cn/v1/pricing",
headers={},
timeout=60,
)
print(r.status_code, r.headers.get("x-points-charged"))
print(r.json())const r = await fetch("https://jusouai.cn/v1/pricing", {
method: "GET"
});
console.log(r.status, r.headers.get("x-points-charged"));
console.log(await r.json());响应 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 搜索 | lite | type=lite | 1 |
POST /v1/exa/search 搜索 | auto 默认 | type=auto 或不填(默认档) | 2 |
POST /v1/exa/search 搜索 | deep | type=deep 或 deep-lite | 4 |
POST /v1/exa/search 搜索 | extra10 | numResults 11–100:超过 10 条的部分每 10 条(不足 10 条按 10 条)加收,与档位积分相加 | +3 / 每 10 条 |
POST /v1/exa/search 搜索 | summary | contents 里要 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 搜索 | advanced | search_depth=advanced | 2 |
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 |