# 星光聚合搜索 聚合搜索网关 多源聚合搜索 API for LLM agents:一次请求并发扇出多个检索源(网页 / 学术 / 代码 / 社区),跨源去重 + RRF 融合排序,可选带引用答案与深度研究报告。OpenAI 兼容端点可让任意客户端改 base_url 即接入。 Base URL: `http://127.0.0.1:8088` · 完整文档: `http://127.0.0.1:8088/llms-full.txt` ## API Reference - Search `POST /v1/search`: 多源并发聚合搜索:跨源去重、RRF;basic/advanced 返回列表,deep 自动阅读 Top 3 — 计费 basic=1 / advanced=2 / deep=3 - Video Download `POST /v1/video/parse`: Douyin / Bilibili video metadata and signed direct download links — 计费 fixed CNY 0.10 per successful video, converted to units - Tools Search `POST /v1/tools/search`: DeepSeek Search API compatible: structured web search for agents/RAG, no LLM call — 计费 1 / successful non-empty search - Tools Fetch `POST /v1/tools/fetch`: DeepSeek Fetch API compatible: fetch a URL and return Markdown content — 计费 1 / successful fetch - Extract `POST /v1/extract`: 把任意 URL 抓成 Markdown / 纯文本,供大模型作上下文 — 计费 1 / 成功 URL - Answer `POST /v1/answer`: 检索后由大模型生成带 [n] 引用标注的答案 — 计费 fast=2 / deep=5 - Research `POST /v1/research`: 深度研究:deep 拆子问题并发检索;agentic 多轮检索+精读+反思补检,产出研究报告 — 计费 deep=5 / agentic=8 - Chat Completions `POST /v1/chat/completions`: OpenAI / DeepSeek compatible chat endpoint; supports server tools deepseek_web_search and deepseek_read_url — 计费 2 + LLM token units - Account `GET /v1/me`: 套餐、余额、限流与 Key 授权信息(免费) — 计费 0 - Usage `GET /v1/usage`: 按天用量序列 + 端点分布 + P50/P95 延迟 + 缓存命中率(免费) — 计费 0 - Signup `POST /v1/signup`: 自助注册试用,赠 500 次额度,返回明文 API Key(仅一次) — 计费 0 - Health `GET /v1/health`: 健康检查:网关状态与可用检索源数量(免鉴权) — 计费 0 ## Docs - [完整接口文档 llms-full.txt](http://127.0.0.1:8088/llms-full.txt): 全部端点参数、计费与错误码细节 - [MCP Server](https://github.com/modelcontextprotocol/spec): 本地 stdio MCP,见项目 `mcp/omnisearch_mcp.py`(工具 search/extract/answer/research/account) - SDK: `sdk/omnisearch.py` 与 `sdk/omnisearch.mjs` 零依赖单文件客户端 ## Optional - [控制台](http://127.0.0.1:5173): 渠道管理 / 用量与营收看板 / 在线调试