InferIndex

InferIndex

InferIndex 会在 60 多个受监控的定价来源（包括供应商直连 API 和聚合商／路由器）中，为指定的大模型找出价格最低的供应商，并提供价格历史和促销检测。

在线 API：https://api.inferindex.dev

服务状态：https://status.inferindex.dev（外部运行时间监控）

本仓库包含该 API 的公开文档、示例，以及（最终会提供的）客户端 SDK。后端本身——数据采集、解析器和数据模型——位于另一个私有仓库中。

curl "https://api.inferindex.dev/cheapest?model=deepseek/deepseek-v3.2"

截至 2026-10-07 的示例响应——价格、供应商和状态会发生变化。

{
  "query": "deepseek/deepseek-v3.2",
  "model": {
    "id": "deepseek/deepseek-v3.2",
    "name": "DeepSeek: DeepSeek V3.2"
  },
  "other_matches": [],
  "sort": "blended",
  "cheapest": {
    "provider": "GMICloud",
    "via": "openrouter",
    "via_name": "OpenRouter",
    "offer_url": "https://openrouter.ai/models",
    "offer_url_kind": "pricing",
    "tier": "standard",
    "input_per_1M": 0.2088,
    "output_per_1M": 0.3096,
    "cache_read_per_1M": 0.0216,
    "blended_per_1M": 0.234,
    "currency": "USD",
    "quantization": "fp8",
    "quantization_source": "declared",
    "context_length": 163840,
    "promo": true,
    "also_via": [
      "kilo"
    ],
    "unverified": []
  },
  "offers": [
    {
      "provider": "GMICloud",
      "via": "openrouter",
      "via_name": "OpenRouter",
      "blended_per_1M": 0.234,
      "…": "…"
    },
    {
      "provider": "Nous Portal",
      "via": "nous",
      "via_name": "Nous Portal",
      "blended_per_1M": 0.234,
      "…": "…"
    }
  ],
  "hidden_tiers": {
    "flex": 1
  },
  "filters_unknown": {},
  "strict": false
}

价格以每百万个 token 的美元计价；如果来源发布的是其他货币，则按当日欧洲央行汇率换算。blended_per_1M 的计算方式为 (3 × input + output) / 4，粗略反映典型聊天工作负载。每项报价只显示一次，取其价格最低的来源：via 为 "direct" 或提供该报价的聚合商，also_via 列出销售同一报价的其他来源。除非检测到促销，否则 promo 为 false；检测到促销时，会填入 confidence 和 price_before_promo。

状态

早期开发中，仍在积极迭代。 API 已公开且可免费使用，无需身份验证，但不保证运行时间，目前也没有版本化的 API 契约，端点或响应结构可能会发生变化。如果你基于它构建项目，请做好相应调整的准备。欢迎反馈和提交问题。

服务状态：https://status.inferindex.dev（外部运行时间监控）。该页面显示当前和过往的可用性，但不构成运行时间保证。

原因

供应商的定价页面彼此不一致，可能在没有通知的情况下变更，而且很少展示转售商对同一模型的实际收费。InferIndex 从 60 多个来源收集价格，每个来源按各自的列表和计划读取（视来源而定，频率从每小时到每天不等），记录每次变更，并基于这些历史数据回答“当前模型 X 哪家最便宜”——客户端请求不会触发对供应商的实时调用。

数据新鲜度和限制

• 缓存：成功的响应会携带 Cache-Control: public, max-age=300（5 分钟）（/health/ready 除外，该端点从不缓存）。在自定义域名上，响应还会在 Cloudflare 边缘缓存中额外保留同样的 5 分钟。
• 数据采集频率：大多数来源每小时轮询一次；少数来源（汇率、模型目录）每天轮询一次。
• 速率限制：/cheapest、/history、/resellers、/self-host、/gpus 和 /gpu-rentals 每个 IP 每分钟限制 60 次请求，只计算未从缓存返回结果的请求。可选的 API 密钥（x-api-key 标头）可将限制提高到每个密钥每分钟 300 次；未来将提供免费密钥，目前尚不支持自助注册。无效密钥会返回 401。超过限制时，请求会收到 429。MCP 服务有其自身的限制，详见与 AI 助手搭配使用。
• 成本估算：向 /cheapest 或 /resellers 添加 prompt_tokens、output_tokens、cached_ratio 和 requests_per_day，即可获取每项报价的单次请求和每月预估成本；添加 sort=estimated_cost 可按预估成本排序。详见文档。
• 默认隐藏的服务层级：默认情况下，/cheapest 和 /resellers 会排除降级服务层级（flex、batch——优先级较低、延迟不固定，但价格更低）。如需包含这些层级，可使用 include_tiers=flex,batch。隐藏的数量会通过 hidden_tiers 报告。

价格可靠性——在相信任何数字前请先阅读

数据更正记录在更新日志中。

InferIndex 是一个比较工具，而非权威来源。请将每个价格视为“我们的采集器上次看到的价格”， 而不是对你将被收取费用的保证：

• 价格来自公开 API；部分来源则通过针对该来源编写的代码解析 HTML 页面——页面改版可能会导致解析器无声失效，直到问题被发现。
• 看起来异常低的价格可能是促销价、单位解析错误，或是提供方尚未更新其页面。InferIndex 会采取防护措施（拒绝不合理的价格、隔离突增的价格，并参照第二个数据源标记异常值），也会根据置信度报告检测到的促销，但这些都是启发式方法，并非确定结论。
• 转售聚合平台可能会加收自己的利润。当某个来源的定价模式尚未完全弄清时，我们会将其排除或标记。
• 在决定实际支出前，请务必在提供方自己的页面或控制面板上确认价格。

端点

路由	功能
GET /cheapest?model=deepseek/deepseek-v3.2	所有活跃来源中的最低价，以及去重并排序后的所有匹配报价
GET /resellers?model=deepseek/deepseek-v3.2	所有转售商（直接或通过聚合平台）的当前价格，每个来源一行；超过 100 个报价时分页
GET /history?model=deepseek/deepseek-v3.2&days=30&granularity=day	价格历史记录，按游标分页
GET /models?search=deepseek	搜索已追踪的模型
GET /gpus	为租赁价格追踪的 GPU 类型，以及每个级别的最低价格——参见 GPU 租赁价格
GET /gpu-rentals?gpu=h100-sxm-80gb	单种 GPU 的租赁报价，每个级别一个区块——参见 GPU 租赁价格
GET /self-host?model=qwen/qwen3-32b&tokens_per_day=50000000	自行租用 GPU 运行开放权重模型是否比使用最低价的 API 报价更便宜？这是仅计算硬件租赁费用的估算——参见答案的计算方式
GET /trending	当前受到关注的最多 10 个模型，约每 6 小时重新计算一次
GET /index?series=market	每周市场指数，自 2026-10-05 起每周一发布——参见方法说明
GET /health/live	仅检查存活状态：服务已启动，不访问数据库
GET /health/ready	就绪状态：数据新鲜度和调度器健康情况，见下文
/mcp	面向 AI 助手的 MCP 服务，参见与 AI 助手搭配使用

/cheapest 筛选条件

• sort=blended\|input\|output — 排序方式（默认值为 blended）
• min_context=100000 — 最小上下文窗口
• quantization=fp8,bf16 — 接受的量化方式
• min_uptime=95 — 最低 30 分钟运行时间（%），由聚合器观测（并非由 InferIndex 测量）
• tools=true、json=true、vision=true — 仅显示声明支持工具调用、JSON 输出、图像输入的选项
• region=eu — 仅显示在该区域处理的选项（eu, us, cn, uk, ch, sg, id, my, vn, kr, jp, in, ca, au），依据提供商的官方文档
• no_training=true — 仅显示提供商声明不会使用提示词进行训练的选项
• no_waitlist=true — 仅显示对所有人开放注册的提供商
• strict=true — 同时排除筛选数据未知的选项（默认情况下会保留这些选项并在 unverified 中标记，计入 filters_unknown）
• include_tiers=flex,batch — 包含服务降级层级（默认排除，见上文）
• explain=true — 列出每个被排除选项及其原因代码（始终包含 explanation 摘要）

选项还附带 conditions（数据区域、保留期限、提示词训练情况，以及开设账户的要求；每项均附有官方来源链接）、quantization_source（计算精度由来源声明还是推断得出），以及 /resellers 上的 reliability（来自提供商的官方状态页面）。参见 docs/api.md。

/history

granularity=raw 会为每次价格变动返回一行；day / week（每周从星期一开始）会按周期和每个选项（提供商、量化方式、变体）返回一个数据点，包含最低价、最高价和最新价格。使用 days 或 from/to 指定时间段，或者使用 at=2026-09-15 获取指定时刻生效的价格。价格按价格日期的欧洲央行汇率换算为 USD。

模型搜索（/models）：

curl "https://api.inferindex.dev/models?search=deepseek"

响应示例截至 2026-09-15 — 价格、提供商和状态可能会变化。

{
  "count": 19,
  "models": [
    { "id": "deepseek/deepseek-v3.2", "name": "DeepSeek: DeepSeek V3.2" },
    { "id": "deepseek/deepseek-v4.1-flash", "name": "DeepSeek: DeepSeek V4.1 Flash" }
  ]
}

/health/ready

响应示例截至 2026-09-15 — 价格、提供商和状态可能会变化。

{
  "ready": true,
  "status": "ok",
  "failures": [],
  "degraded": [],
  "warnings": ["2 price source(s) in error", "1 announcement source(s) in error"],
  "prices": { "current_offers": 5664, "latest_check_at": "2026-09-15T05:01:05.639Z", "latest_check_age_minutes": 1.5 },
  "watcher": { "active_sources": 84, "errors": 1, "persistent_errors": 0, "latest_check_at": "2026-09-15T05:02:08.890Z", "latest_check_age_minutes": 0.4 },
  "schedulers": { "active": 62, "ok": 62, "starting": 0, "late": 0, "not_started": 0 },
  "source_errors": { "count": 1, "persistent": 0 },
  "version": { "id": "…", "tag": "", "deployed_at": "…" },
  "checked_at": "2026-09-15T05:02:34.383Z"
}

status 为 ok、degraded（非关键部分遇到问题 — 请查看 degraded 数组了解具体情况）或 unavailable（没有可用的价格数据）。ok / degraded 返回 HTTP 200，unavailable 返回 503。如果你依赖此 API，可将其用作运行时间监控目标。

完整的路由和参数参考：docs/api.md。

与 AI 助手配合使用（MCP）

InferIndex 也可作为远程 MCP 服务使用，因此 AI 助手可以帮你 查询价格：

• 端点：https://mcp.inferindex.dev/mcp（Streamable HTTP） （别名 https://api.inferindex.dev/mcp 也可使用）
• 已在官方 MCP Registry 中列出，名称为 io.github.InferIndex/inferindex。
• **只读，无需身份验证。**可在 x-api-key 标头中传入 API 密钥。
• 限额：/mcp 每个 IP 每分钟 120 次请求，每个批次最多 10 条 JSON-RPC 消息，每次请求不超过 64 KB （否则返回 400 或 413，并附带 JSON-RPC 错误 -32600）。超过速率限制时，返回 429，并附带 JSON-RPC 错误 -32000。每次工具调用也会计入其所用 API 路由的限额（/cheapest、/resellers、/history、/self-host、/gpus、/gpu-rentals）。

工具	功能
search_models(query)	查找模型的准确 ID
cheapest(model, …)	最低价优惠，支持与 /cheapest 相同的筛选条件（min_context、tools、json、vision、region、no_training、no_waitlist、strict、include_tiers），可选用量参数（prompt_tokens、output_tokens、cached_ratio、requests_per_day）和 limit
compare_providers(model, sort, limit, …)	列出所有优惠，每个服务商一行，包含用量条件和可靠性
price_history(model, days | from + to | at, granularity, provider, limit)	优惠价格历史，以及实验室公布的官方价格
estimate_cost(model, prompt_tokens, output_tokens, cached_ratio, requests_per_day)	估算每次请求和每月的费用，并排序
list_gpus()	跟踪租赁价格的 GPU 类型，并列出各档位的最低价格
gpu_rentals(gpu, tier, gpu_count, region, detail)	单种 GPU 的租赁优惠，每个档位占一个区块
self_host_or_api(model, tokens_per_day, utilization, …)	在租赁的 GPU 上自托管开放权重模型，还是使用最低价的 API 优惠？仅适用于硬件租赁，参见答案的构建方式

每个结果都包含 api_url，即对应的 API 调用，方便你检查或重复使用。

默认情况下，cheapest、compare_providers 和 estimate_cost 会返回精简视图：详细显示最优优惠，其他每项优惠各占一行简述。传入 detail: "full" 可获取每项优惠的所有字段。在精简视图中，未出现的条件表示服务商未公布该条件（并不表示“否”）；未列在 signals 中的标记则为 false。

设置

对于 Cline 和其他自行安装服务的 Agent，请参阅 llms-install.md。

Claude Code

claude mcp add --transport http inferindex https://mcp.inferindex.dev/mcp

使用 API 密钥时，添加 --header "x-api-key: YOUR_KEY"。

Claude Desktop / claude.ai：设置 → 连接器 → 添加自定义连接器，URL 为 https://mcp.inferindex.dev/mcp。 较旧版本的 Claude Desktop，请在 claude_desktop_config.json 中配置：

{ "mcpServers": { "inferindex": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.inferindex.dev/mcp"] } } }

Cursor：一键添加，或手动添加。

在 ~/.cursor/mcp.json 中：

{ "mcpServers": { "inferindex": { "url": "https://mcp.inferindex.dev/mcp" } } }

使用 API 密钥时，在 "url" 旁添加 "headers": { "x-api-key": "YOUR_KEY" }。

Codex CLI

codex mcp add inferindex --url https://mcp.inferindex.dev/mcp

或者在 ~/.codex/config.toml 中：

[mcp_servers.inferindex]
url = "https://mcp.inferindex.dev/mcp"

使用 API 密钥时，在该表中添加 env_http_headers = { "x-api-key" = "INFERINDEX_API_KEY" }，并设置 INFERINDEX_API_KEY 环境变量。

贡献

欢迎提交文档修复和示例贡献——请发起拉取请求或提交问题。本仓库仅涵盖公共 API 部分；后端本身并非开源。

许可证

• 文档（本 README、docs/）：CC BY 4.0。你可以自由复用和改编，但需注明 InferIndex。
• 代码（示例、代码片段、客户端 SDK）：MIT。

这些许可证仅适用于本仓库，不适用于 InferIndex 后端或其价格数据。