API 文档
先看全貌,再开始接入
EveryInfra 不是一个单一端点,而是两类核心 API + 一个 MCP 协议入口:数据 API 负责取数,Gemini 文本 API 负责生成和分析,MCP 让 AI 客户端自动调用前两类能力。三者共用同一把 API Key 和同一个 ¥ 钱包。
我们提供什么
统一数据 API
POST /api/v1/social用同一个请求结构获取社交内容、点评口碑、电商评论与全网搜索数据。
适合: 舆情监控、竞品研究、评论分析、RAG 数据源和 Agent 联网取数。
Gemini 文本 API
POST /api/v1/chat/completionsOpenAI 兼容的文本生成与分析接口，默认使用 Gemini 3.6 Flash。
适合: 批量打标、主题分类、线索判断、摘要、翻译和结构化字段抽取。
MCP 远程服务器
POST /mcp让 Claude、ChatGPT、Cursor 等客户端直接调用数据 API 和 Gemini 文本 API。
适合: 不想手写 HTTP 的 AI Agent、桌面客户端、IDE 和自动化工作流。
GET /api/v1/social/catalog 查看全部数据能力,GET /api/v1/models 查看模型列表,GET /api/v1/jobs/{job_id} 轮询异步数据任务。它们不是第三、第四类付费 API。怎么选择入口
| 你的目标 | 选择 | 入口 | 得到什么 |
|---|---|---|---|
| 搜索帖子、评论、用户、商品或网页 | 统一数据 API | POST /api/v1/social | 结构化 JSON 数据 |
| 生成、摘要、翻译、分类、打标或抽取字段 | Gemini 文本 API | POST /api/v1/chat/completions | OpenAI 格式文本结果 |
| 让 Claude / ChatGPT / Cursor 自己选工具 | MCP | POST /mcp | 3 个可调用工具 |
Gemini 模型目录与选择
所有 model ID 都通过同一个 POST /api/v1/chat/completions 调用。gemini-3.6-flash 是默认推荐;如果不确定选哪个,就用它。模型 ID 是不同任务偏好的兼容入口,不代表每一个名字背后都有独立的付费订阅模型。
| 模型 ID | 定位 | 推荐场景 | 典型输出 |
|---|---|---|---|
gemini-3.6-flash默认推荐 | 最新快速通用文本模型 | 大规模打标、分类、摘要、翻译、线索判断和结构化抽取 | 典型中文输出约 1.2 万汉字 |
gemini-3.5-flash通用兼容 | 上一代快速通用文本模型 | 已有 3.5 工作流的兼容接入和普通文本任务 | 典型中文输出约 1.2 万汉字 |
gemini-3.5-flash-thinking深度思考 | 更偏多步骤分析与长输出 | 复杂归因、方案比较、需要展开分析过程的任务 | 典型中文输出约 2 万汉字 |
gemini-3.5-flash-thinking-lite轻量思考 | 速度与分析深度之间的折中 | 中等复杂度分类、解释、审核和信息整理 | 典型中文输出约 1.5 万汉字 |
gemini-auto自动选择 | 由上游自动选择合适的 Flash 路由 | 不想固定具体模型、希望保留上游自动选择空间的任务 | 输出量随自动选择结果变化 |
gemini-flash-lite轻量快速 | 面向简单短文本任务的轻量兼容标识 | 短摘要、改写、基础分类和低复杂度抽取 | 典型中文输出约 1 万汉字 |
gemini-3.1-pro兼容标识 | 保留给既有客户端的 Pro 模型名 当前生产上游没有付费 Cookie，实际会回落到 Flash 路由，不应把它当作真实 Pro 能力。 | 仅用于需要该 model ID 的兼容场景 | 当前匿名线路典型输出约 1.2 万汉字 |
全部模型标识共用约 2 万 token 的可靠单次输入范围；更长文档请在客户端切块。
公开网关当前只提供非流式文本响应，不提供可靠的图片、PDF、音频或视频理解。
每次请求独立；多轮上下文需要在 messages 中携带历史消息。
快速开始
加微信领 ¥5 免费额度(≈500 次数据调用或 400 次 AI 调用)。拿到 API Key 后,先选择你要调用的入口;下面以统一数据 API 为例:
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer omg_live_你的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 / 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} 轮询,完成后取结果。只在提交时计费一次,轮询免费。
Gemini 文本 API
模型目录见上方。接口本身是 OpenAI 兼容的文本生成与分析入口;默认且推荐使用 gemini-3.6-flash,适合大量彼此独立的短文本分析,包括评论情绪打标、主题分类、线索意向判断、内容审核预筛、摘要和结构化字段抽取。
可靠输入约 2 万 token(约 2.5 万汉字或 10 万英文字符),典型中文输出可到约 1.2 万汉字。超过可靠输入范围时,上游可能报错或静默忽略后半段,因此长文档必须在客户端切块后再汇总。
当前公开网关是非流式文本线路:支持 OpenAI 格式的 system / user / assistant 消息,多轮对话由每次请求携带完整历史实现。不要依赖图片、PDF、音频或视频输入;公开网页 URL 只适合读取其文字内容。
from openai import OpenAIclient = OpenAI( base_url="https://api.everyinfra.com/api/v1", api_key="omg_live_你的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 ThreadPoolExecutorfrom openai import OpenAIclient = OpenAI(base_url="https://api.everyinfra.com/api/v1", api_key="omg_live_你的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.contentwith 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 文本调用)。两个付费调用工具与对应 REST API 共用计费规则,目录工具免费。鉴权二选一:请求头 Authorization: Bearer <API Key>,或连接器 URL 后缀 ?key=<API Key>(部分客户端只支持配置 URL,没有自定义请求头的入口)。首页有平台切换 + 一键部署,登录后控制台「MCP 接入」页能直接生成带你专属 Key 的可用配置。
错误码
| 401 unauthorized | Key 缺失或无效 |
| 402 quota_exhausted | 钱包余额不足,充值后重试 |
| 403 account_disabled | 账号被停用,联系我们或你的服务商 |
| 400 unknown_capability | platform / action 不存在,查 catalog |
| 422 missing_param | 必填参数缺失,message 会指出是哪个 |
| 429 rate_limited | 触发限速,稍后重试 |
| 503 upstream_error | 上游临时故障(不计费),重试即可 |
| 503 timeout | 同步调用超过 280s 上限(不计费),message 会给出具体建议:调小 limit 或改用异步能力 |
| 422 input_too_large | AI 端点 messages 合计超过 200,000 字符(不计费),拆成多次请求 |
计费
一个 ¥ 钱包跨服务扣费:数据/搜索按平台分四档 ¥0.004–0.04/次(对标档 ¥0.004 / 标准档 ¥0.01 / 深度档 ¥0.02 / 高难档 ¥0.04),Gemini 3.6 Flash 文本调用 ¥0.0125/次;失败或空响应不计费,余额长期有效。累计充值阶梯折扣:≥¥1,000 全站 9 折,≥¥5,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 列表,没采到的那几个不收钱。