EverySearch 交叉验证 API
POST
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
正常
24 小时趋势
30 天趋势
同一个问题并行跑多种机制不同的检索链,按「被几种机制同时命中」给来源分层,再取回最高层来源的一手原文。它回答的不是「搜到了什么」,而是「这个结论有多可信、什么时候别信」
单价 $2.78 / 千次(每次 $0.002778),失败和空结果都不收费。 一次调用按 4 次检索计:并行跑 4 种机制不同的检索链;只跑通一部分时按跑通的条数收,不超过标价。
AI 提示词
#请帮我用 EveryInfra 的「交叉验证」接口写一个调用脚本。
接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/search,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 tool 填 crosscheck,参数放在 params 里。
- 必填参数:
- q:要核对的问题或结论。
- 可选参数:
- num:每条检索链取回的结果条数。
- since:只要这个日期之后的来源。
- read_top:取回原文的最高层来源个数;0 表示不取原文。
- depth:不传 mechanisms 时用的默认组合:quick 只跑关键词,standard 加语义,deep 跑全部四种。(可选值:quick / standard / deep)
- mechanisms:直接指定要跑的检索机制;传了就不看 depth。(可选值:keyword / index / semantic / reasoning / community)
- 示例请求体:
{
"tool": "crosscheck",
"params": {
"q": "Python 3.13 release date",
"depth": "quick",
"num": 5
}
}
- 计费:单价 $2.78 / 千次(每次 $0.002778),失败和空结果都不收费。 一次调用按 4 次检索计:并行跑 4 种机制不同的检索链;只跑通一部分时按跑通的条数收,不超过标价。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。
写代码前,先问清楚我要处理多少个、结果存成什么格式,再把方案和大概花费讲给我确认。请求参数
#| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
Authorization | header | string | 是 | - | Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。 |
tool | body | string | 是 | crosscheck | 工具名,固定值。 |
q | body.params | string | 是 | - | 要核对的问题或结论。 |
num | body.params | integer (1–10) | 否 | 8 | 每条检索链取回的结果条数。 |
since | body.params | date | 否 | - | 只要这个日期之后的来源。 |
read_top | body.params | integer (0–) | 否 | 2 | 取回原文的最高层来源个数;0 表示不取原文。 |
depth | body.params | string (enum) | 否 | deep | 不传 mechanisms 时用的默认组合:quick 只跑关键词,standard 加语义,deep 跑全部四种。允许值quickstandarddeep |
mechanisms | body.params | array | 否 | - | 直接指定要跑的检索机制;传了就不看 depth。允许值keywordindexsemanticreasoningcommunity |
代码示例
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/search' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"tool": "crosscheck",
"params": {
"q": "Python 3.13 release date",
"depth": "quick",
"num": 5
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。
响应示例
#2026年10月25日 02:28(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息;id、billing、quota 每次调用都不同,只给结构。
json
{ "id": "req_…", "object": "search.crosscheck", "query": "Python 3.13 release date", "lanes": [ { "lane": "keyword", "label": "关键词索引", "mechanism": "keyword", "corpus": "open_web", "description": "按查询词与链接权重召回,覆盖广、时效好,但只能找到标题或正文里确实含有查询词的页面", "status": "ok", "results": 5, "latency_ms": 2386 }, { "lane": "index", "label": "索引检索", "mechanism": "index", "corpus": "open_web", "description": "自有网页索引,条目自带正文摘要,适合直接判断这一页说了什么", "status": "ok", "results": 5, "latency_ms": 5437 } ], "independence": { "mechanisms_planned": 2, "mechanisms_live": 2, "lanes_planned": 2, "lanes_live": 2, "degraded": false, "live": [ "index", "keyword" ], "missing": [] }, "agreement": { "by_url": [ { "url": "https://docs.python.org/3/whatsnew/3.13.html", "title": "What's New In Python 3.13", "mechanisms": [ "index", "keyword" ], "lanes": [ "index", "keyword" ], "mechanism_count": 2 }, { "url": "https://peps.python.org/pep-0719/", "title": "PEP 719 – Python 3.13 Release Schedule", "mechanisms": [ "index", "keyword" ], "lanes": [ "index", "keyword" ], "mechanism_count": 2 }, { "url": "https://endoflife.date/python", "title": "Python", "mechanisms": [ "keyword" ], "lanes": [ "keyword" ], "mechanism_count": 1 } ], "by_domain": [ { "domain": "docs.python.org", "mechanisms": [ "index", "keyword" ], "lanes": [ "index", "keyword" ], "mechanism_count": 2 }, { "domain": "peps.python.org", "mechanisms": [ "index", "keyword" ], "lanes": [ "index", "keyword" ], "mechanism_count": 2 }, { "domain": "python.org", "mechanisms": [ "index", "keyword" ], "lanes": [ "index", "keyword" ], "mechanism_count": 2 } ], "max_url_mechanisms": 2, "max_domain_mechanisms": 2 }, "unique_finds": [ { "url": "https://endoflife.date/python", "title": "Python", "mechanism": "keyword", "lane": "keyword" }, { "url": "https://www.reddit.com/r/Python/comments/1fybncq/python_313_released/", "title": "Python 3.13 released", "mechanism": "keyword", "lane": "keyword" }, { "url": "https://thenewstack.io/python-3-13-blazing-new-trails-in-performance-and-scale", "title": "Python 3.13: Blazing New Trails in Performance and Scale - The New Stack", "mechanism": "index", "lane": "index" } ], "answers": [], "excerpts": [ { "url": "https://docs.python.org/3/whatsnew/3.13.html", "mechanism_count": 2, "content": "### Navigation\n\n* [index](../genindex.html \"General Index\")\n* [modules](../py-modindex.html \"Python Module Index\") |\n* [next](3.12.html \"What’s New In Python 3.12\") |\n* [previous](3.14.html \"What’s new in Python 3.14\") |\n* [Python](https://www.python.org/) »\n* [3.15.1 Documentati…", "fetched": false }, { "url": "https://peps.python.org/pep-0719/", "mechanism_count": 2, "content": "# Python Enhancement Proposals\n\n* [Python](https://www.python.org/ \"The Python Programming Language\") »\n* [PEP Index](../ \"Python Enhancement Proposals (PEPs)\") »\n* PEP 719\nPEP 719 – Python 3.13 Release Schedule\n\n# PEP 719 – Python 3.13 Release Schedule\n\nAuthor:\n: Thomas Wouter…", "fetched": false } ], "verdict": { "level": "weak", "text": "⚠ 只有 2 条独立检索链在跑,交叉验证强度显著下降(满强度为 3 种以上互不相同的检索机制) 两种机制之间的一致只是弱印证:机制越少,一致越可能来自同源取材而非互相印证。请以一手原文为准。 有 2 种机制落在**同一个页面**上,这比落在同一个域名上强得多(同域名可能是不同帖子在说相反的话)。" }, "notes": [], "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足,先充值。
- 422
- 参数名或取值不对,按错误信息给的候选改;不扣费。
- 429
- 超过每分钟请求上限,按 Retry-After 等待后再试。
- 503
- 暂时无法完成,预扣的费用退回;结果未知时先核对,不要直接重发。
- 200 空结果
- 没有数据,不扣费。