接入文档

注册后在控制台「API Keys」页获取密钥(形如 ais-xxxxxxxx)。

1. 搜索 API(Tavily 风格)

curl -X POST https://your-domain/v1/search \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer ais-xxxxxxxx' \
  -d '{
    "query": "golang gin tutorial",
    "max_results": 8,
    "include_content": false,
    "topic": "general",
    "freshness": "week",
    "language": "en"
  }'
  • topic: "news" 切换新闻引擎(Google News + Bing News);freshness 支持 day/week/month(注:freshness 仅对新闻引擎生效,普通引擎暂不支持时间过滤)
  • include_content: true 时对前几条结果抓取正文(readability 抽取)
  • 响应 data.results[] 含 title/url/snippet/content/source/score;data.engines 为各引擎状态
  • 同一查询 30 分钟内命中缓存,cached=true 且不计费

2. OpenAI SDK 兼容

from openai import OpenAI
client = OpenAI(base_url="https://your-domain/v1", api_key="ais-xxxxxxxx")
resp = client.chat.completions.create(
    model="any",                      # 未配置 LLM 时 model 仅为占位
    messages=[{"role": "user", "content": "gin 框架最新版本有什么特性?"}],
)
print(resp.choices[0].message.content)  # 返回带引用链接的搜索结果

服务端配置 LLM 上游后,该接口返回由搜索结果接地的生成式回答(带 [#1] 引用),支持 stream。

3. MCP(Claude / Cursor)

{
  "mcpServers": {
    "aisearch": {
      "type": "http",
      "url": "https://your-domain/mcp",
      "headers": { "Authorization": "Bearer ais-xxxxxxxx" }
    }
  }
}

提供 web_searchextract_page 两个工具。

4. 用量 / 余额 / 状态

  • GET /v1/usage — 本 Key 近 30 天用量与费用(Bearer 鉴权)
  • 控制台「用量统计」「余额/充值」页可视化全部账单
  • GET /v1/engines · /v1/pool · /v1/metrics — 引擎/代理池/全局指标
  • 公共状态页:/status(免登录)

5. 在线试一下(Playground)

填入 Key 后点击搜索,结果实时展示(Key 仅存在于当前页面内存,不会存储)

6. 限流与计费

  • 每 Key 独立令牌桶限流(RPM,默认 60,可调至 600),超额 429
  • 可设每日请求上限;余额为零返回 402
  • 只按计费请求收费(缓存命中免费),详见定价