API 文档

先看全貌,再开始接入

EveryInfra 不是一个单一端点。核心是数据 API（取数）与 Gemini 文本 API（生成与分析）;此外还有搜索与验证码识别两个付费端点。MCP 不是另一类能力,而是让 AI 客户端自动调用上述 API 的协议入口。所有入口共用同一把 API Key 和同一个钱包。

我们提供什么

怎么选择入口

Gemini 模型目录与选择

所有 model ID 都通过同一个 POST /api/v1/chat/completions 调用。gemini-3.6-flash 是默认推荐;如果不确定选哪个,就用它。模型 ID 是不同任务偏好的兼容入口,不代表每一个名字背后都有独立的付费订阅模型。

快速开始

加微信领 $1 免费额度(≈720 次数据调用或 576 次 AI 调用)。拿到 API Key 后,先选择你要调用的入口;下面以统一数据 API 为例:

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"xiaohongshu","action":"search",
       "params":{"keyword":"露营","limit":20}}'

{
  "platform": "xiaohongshu",
  "action": "search",
  "count": 20,
  "results": [ { "id": "...", "title": "...", "like_count": 3280 } ],
  "quota": { "remaining_cny": 47.5, "remaining_credits": 470000 }
}

鉴权

每个请求带上 Authorization 头,值为 Bearer <你的 API Key>。API Key 在 控制台 创建,完整 Key 仅在创建时显示一次。Base URL:https://api.everyinfra.com。

统一数据 API

一个端点通吃全部数据能力。请求体三要素:platform(平台标识,如 xiaohongshu / google_maps_reviews / amazon)、action(动作,如 search / user_posts / reviews / comments)、params(动作参数,如 keyword / url / limit)。换平台只换 platform 字段,响应结构统一。

支持的渠道与能力

87 平台 / 387 能力,三大域:社交内容(小红书、抖音、Instagram、X、TikTok、YouTube、微博、知乎、公众号、B站、Reddit 等)、点评口碑(谷歌地图、TripAdvisor、Yelp、Trustpilot、Glassdoor、App Store、Google Play 等,按 URL/域名取评论)、电商(Amazon、速卖通、eBay、Etsy、Temu 等)+ 全网搜索。完整清单看 GET /api/v1/social/catalog(免费,不计费;含每个能力的必填/可选参数、单次条数上限和单价)。其中 70 个平台是同类服务完全没有的 —— 点评、招聘、电商、设计社区、房产,不只是社媒。

异步任务

异步动作包括 Facebook 主页/帖子/评论、Instagram 用户帖子/发现和 LinkedIn 评论。提交后立即返回 job_id,用 GET /api/v1/jobs/{job_id} 轮询,完成后取结果。只在提交时计费一次,轮询免费。

搜索 API（EverySearch）

一个端点 POST /api/v1/search，17 个工具，请求体用 tool 选：网页 / 语义 / 深度检索 / 学术与专利 / 新闻 / 商品 / 地点 / 图像与视频 / 反向图搜 / 论坛 / 正文抓取 / 整站爬取 / 站点结构 / 相似页面 / 联想词 / 交叉验证 / 长任务抓取。工具目录 GET /api/v1/search/tools 不鉴权、免费，带每个工具的参数与单价。

三档定价：标准 $0.69 / 千次 / 深度 $1.39 / 千次 / 交叉验证 $2.78 / 千次。绝大多数工具都在标准档；深度检索与交叉验证单独定价是因为它们背后跑的东西不同 —— 前者上游本身贵一倍、慢十几倍，后者并行跑四条机制不同的检索链再交叉分层。

curl -X POST https://api.everyinfra.com/api/v1/search \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"web","query":"EU AI Act 合规要求","num":10}'

验证码识别 API（EverySolve）

一个端点 POST /api/v1/captcha，53 种类型，$0.14 / 千次–$4.58 / 千次。请求体第一个字段永远是 type，其余参数逐类型不同。能力目录 GET /api/v1/captcha/types 不鉴权、免费，带每种类型的必填/可选参数、解的形状和单价 —— 而且带 available 字段如实反映此刻能不能卖，别把它缓存起来当静态数据用。

按成功计费，失败一律退款：解不出来、上游故障、超时都不扣钱。空解也退。

curl -X POST https://api.everyinfra.com/api/v1/captcha \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"turnstile",
       "website_url":"https://example.com/login",
       "website_key":"0x4AAAAAAA..."}'

{
  "type": "turnstile",
  "solution": { "token": "0.aBcD..." },
  "token": "0.aBcD...",          // 标量解额外给一个顶层字段，省一层取值
  "billing": { "charged": true, "credits": 20, "cny": 0.002 }
}

⚠ 解的形状有 8 种，接入前先确认你这一类是哪种。 这是这条 API 最容易写错的地方：不同验证码交付的东西根本不是一类东西，有的是一个字符串填回表单，有的是一组坐标要你自己去点。solution 里的字段名以目录返回的 solution.keys 为准。

前四种是单个标量，响应会额外给一个顶层 token 字段，省掉一层取值；后三种不是标量，没有顶层 token，只能从 solution 里取。坐标和矩形的数值一律是数字、键名一律 snake_case。

有几类要你自带代理（目录里 proxy 在必填里的那些）：它们交付的是 Cookie 而不是 token，而 Cookie 绑定求解时的出口 IP —— 用我们的出口解出来，你拿去用是无效的。所以代理必须是你后续请求要用的那个出口。

Gemini 文本 API

模型目录见上方。接口本身是 OpenAI 兼容的文本生成与分析入口;默认且推荐使用 gemini-3.6-flash,适合大量彼此独立的短文本分析,包括评论情绪打标、主题分类、线索意向判断、内容审核预筛、摘要和结构化字段抽取。

可靠输入约 2 万 token(约 2.5 万汉字或 10 万英文字符),典型中文输出可到约 1.2 万汉字。超过可靠输入范围时,上游可能报错或静默忽略后半段,因此长文档必须在客户端切块后再汇总。

当前公开网关是非流式文本线路:支持 OpenAI 格式的 system / user / assistant 消息,多轮对话由每次请求携带完整历史实现。不要依赖图片、PDF、音频或视频输入;公开网页 URL 只适合读取其文字内容。

from openai import OpenAI

client = OpenAI(
    base_url="https://api.everyinfra.com/api/v1",
    api_key="omg_你的KEY",
)
r = client.chat.completions.create(
    model="gemini-3.6-flash",
    messages=[{
        "role": "user",
        "content": "只返回 JSON:给这条评论标注 sentiment、topic 和 intent",
    }],
)
print(r.choices[0].message.content)

批量打标与高并发

每个 API Key 默认 60 RPM,可在控制台一次性解锁 180 / 600 / 1,800 RPM。底层对上游设置 2,000 个在飞请求的排队保护,用于吸收突发批量任务;这不是公开吞吐 SLA,实际速度仍取决于输入、输出长度和当前队列。

客户端应使用有界并发池,不要一次性创建无限任务。对 429 按 Key 限速退避,对 503 做带抖动的指数退避;每条任务保留自己的业务 ID,便于幂等重试和结果对账。推荐先让模型只返回固定 JSON schema,再在客户端校验失败项。

from concurrent.futures import ThreadPoolExecutor
from openai import OpenAI

client = OpenAI(base_url="https://api.everyinfra.com/api/v1", api_key="omg_你的KEY")
comments = ["物流很快,包装也很好", "功能一般,价格偏高"]

def label(text: str):
    return client.chat.completions.create(
        model="gemini-3.6-flash",
        messages=[{"role": "user", "content": f"只返回 JSON，字段为 sentiment/topic/intent：{text}"}],
    ).choices[0].message.content

with ThreadPoolExecutor(max_workers=10) as pool:
    results = list(pool.map(label, comments))

MCP 接入

让 Claude、ChatGPT、Cursor 等支持 MCP(Model Context Protocol)的客户端直接把 EveryInfra 当工具用,不用手写 HTTP 调用。远程服务器地址 POST https://api.everyinfra.com/mcp(Streamable HTTP,无需本地安装),六个工具,四条付费线全覆盖:everyinfra_list_capabilities(查平台/能力目录)、everyinfra_call_api(调用任意数据能力)、everyinfra_chat(Gemini 文本调用)、everyinfra_list_captcha_types(查验证码类型与解的形状)、everyinfra_solve_captcha(解验证码)、everyinfra_search(检索)。两个目录工具免费,四个付费工具与对应 REST API 共用完全相同的计费、限流与退款规则。鉴权二选一:请求头 Authorization: Bearer <API Key>,或连接器 URL 后缀 ?key=<API Key>(部分客户端只支持配置 URL,没有自定义请求头的入口)。首页有平台切换 + 一键部署,登录后控制台「MCP 接入」页能直接生成带你专属 Key 的可用配置。

错误码

计费

一个钱包跨服务扣费:数据/搜索按平台分4档 $0.56 / 千次–$5.56 / 千次(对标档 $0.56 / 千次 / 标准档 $1.39 / 千次 / 深度档 $2.78 / 千次 / 高难档 $5.56 / 千次),Gemini 3.6 Flash 文本调用 $1.74 / 千次;失败或空响应不计费,余额长期有效。折扣一条阶梯、两种达成:按累计充值(≥$150 9 折 / ≥$750 7 折,终身有效)或按当日请求量(≥1,000 次 9 折 / ≥10,000 次 7 折,当天生效),取更优的那个,按调用时档位自动计价。详见定价页。

每次付费调用的响应里都带 billing 字段,写明本次实际扣了多少与计价依据,不用回查账单就能对账:

"billing": {
  "charged": true,              // 本次是否真的扣费（空结果/失败为 false）
  "credits": 400,               // 实扣 credits
  "cny": 0.04,                  // 实扣金额
  "list_price_credits": 400,    // 该能力的标价（未折、未乘目标数）
  "tier_credits": 400,          // 平台档单价
  "discount_rate": 0.9,         // 生效折扣（无折扣时不出现）
  "units": 20                   // 扇出能力按目标数计费时出现
}

扇出能力(一次传多个 URL)按实际成功的目标数计费:部分目标没采到时响应带 partial: true 与 missed 列表,没采到的那几个不收钱。