注册后在控制台「API Keys」页获取密钥(形如 ais-xxxxxxxx)。
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 为各引擎状态cached=true 且不计费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。
{
"mcpServers": {
"aisearch": {
"type": "http",
"url": "https://your-domain/mcp",
"headers": { "Authorization": "Bearer ais-xxxxxxxx" }
}
}
}提供 web_search 与 extract_page 两个工具。
GET /v1/usage — 本 Key 近 30 天用量与费用(Bearer 鉴权)GET /v1/engines · /v1/pool · /v1/metrics — 引擎/代理池/全局指标填入 Key 后点击搜索,结果实时展示(Key 仅存在于当前页面内存,不会存储)