开发文档

与 AnySearch 官方 /v1/search 一致：请求体、返回体原样，只把 request_id 换成我方的。

兼容官方接口：把官方地址 https://api.anysearch.com/v1/search 换成 https://jusouai.cn/v1/anysearch/search，密钥换成聚搜GO 密钥即可。

参数

请求示例

curl https://jusouai.cn/v1/anysearch/search \
  -H "Authorization: Bearer $JUSOU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "量子计算 最新进展", "max_results": 5}'

返回示例

{
  "code": 0,
  "message": "success",
  "request_id": "js-20261031120000-a1b2c3d4e5f6",
  "data": {
    "results": [
      {
        "title": "…",
        "url": "https://example.com/a",
        "snippet": "…",
        "content": "…"
      }
    ]
  }
}

一种写法调任意引擎，返回统一结构；某引擎不支持的公共参数返回 400 说明，不静默忽略。

参数

请求示例

curl https://jusouai.cn/v1/search \
  -H "Authorization: Bearer $JUSOU_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine": "anysearch", "query": "量子计算", "num_results": 5}'

返回示例

{
  "request_id": "js-20261031120000-a1b2c3d4e5f6",
  "engine": "anysearch",
  "results": [
    {
      "title": "…",
      "url": "https://example.com/a",
      "snippet": "…",
      "content": "…",
      "published_at": "…",
      "score": null
    }
  ],
  "points_charged": 1,
  "points_tier": "standard"
}

不带密钥时：兑换并开户，返回 api_key（只显示一次）。带密钥时：兑换到当前账户。

参数

请求示例

curl https://jusouai.cn/v1/redeem \
  -H "Content-Type: application/json" \
  -d '{"code": "JS-ABCD-EFGH-JKLM"}'

返回示例

{
  "customer_id": 1,
  "plan": "体验卡",
  "points": 100,
  "daily_points": null,
  "ends_at": "2026-11-30 12:00:00",
  "api_key": "jsk_…",
  "notice": "这是你的 API 密钥，只显示这一次，请立即保存"
}

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

参数

无请求参数。

请求示例

curl https://jusouai.cn/v1/me \
  -H "Authorization: Bearer $JUSOU_KEY"

返回示例

{
  "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
}

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

参数

无请求参数。

请求示例

curl https://jusouai.cn/v1/engines

返回示例

{
  "engines": [
    {
      "name": "anysearch",
      "label": "AnySearch",
      "status": "live",
      "category": "网页搜索",
      "paths": [
        "/v1/anysearch/search"
      ]
    }
  ]
}

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

参数

请求示例

curl https://jusouai.cn/v1/usage \
  -H "Authorization: Bearer $JUSOU_KEY"

返回示例

{
  "items": [
    {
      "request_id": "js-…",
      "engine": "anysearch",
      "operation": "search",
      "tier": "standard",
      "points": 1,
      "outcome": "ok",
      "result": "成功",
      "created_at": "2026-10-31 12:00:00"
    }
  ]
}

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

参数

请求示例

curl https://jusouai.cn/v1/usage/summary \
  -H "Authorization: Bearer $JUSOU_KEY"

返回示例

{
  "period": "7d",
  "since": "2026-10-25 00:00:00",
  "engines": [
    {
      "engine": "anysearch",
      "label": "AnySearch",
      "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
  }
}

每个引擎每个操作 · 档位每次调用的固定积分（含触发条件），以及在售套餐（calls_est = 约可调用基础搜索次数）。一份积分所有引擎通用。

参数

无请求参数。

请求示例

curl https://jusouai.cn/v1/pricing

返回示例

{
  "engines": [
    "anysearch"
  ],
  "base_points": 1,
  "rules": [
    {
      "engine": "anysearch",
      "operation": "search",
      "tier": "standard",
      "points": 1,
      "condition": "任意参数",
      "is_default": 1
    }
  ],
  "groups": [
    {
      "engine": "anysearch",
      "label": "AnySearch",
      "operations": [
        {
          "operation": "search",
          "label": "搜索",
          "method": "POST",
          "path": "/v1/anysearch/search",
          "tiers": [
            {
              "tier": "standard",
              "condition": "任意参数",
              "points": 1,
              "default": true
            }
          ]
        }
      ]
    }
  ],
  "plans": [
    {
      "id": 1,
      "kind": "trial",
      "name": "体验卡",
      "price_fen": 990,
      "points": 100,
      "days": 30,
      "qps": 2,
      "buy_url": "",
      "calls_est": 100
    }
  ]
}

• 一份积分，所有引擎通用：任何套餐的积分都能调所有已开放引擎，不按引擎划分；只是不同引擎、档位每次扣分不同。
• 按调用次数扣固定积分，一次一价：基础搜索 1 积分/次，高级档（AI 搜索、深度搜索、更多结果条数）3–5 积分起；每次扣多少由「接口 · 档位」决定（见下方价目），没有附加费，也不会事后补扣。
• 档位由请求参数决定（如某个参数取某个值），对照价目里的「触发条件」；没写到的取值按该操作的默认档计。
• 调用成功（含结果为空）照价目扣分；参数错误、引擎故障、超时、繁忙、暂不可用都不扣分。
• 每次响应头带 x-request-id、x-points-charged（本次扣分，未扣为 0）和 x-points-tier（本次计费档位）。
• 控制台「按引擎扣分明细」可看今日 / 近 7 天 / 近 30 天各引擎的调用次数与扣分；GET /v1/usage/summary 同口径。

AnySearch（anysearch）

错误统一返回 {"error": {"code": "…", "message": "…"}, "request_id": "…"}；原生兼容接口在引擎判定参数错时，原样返回该引擎的错误结构（HTTP 400）。