Modelmeter

Modelmeter

AI 技术栈的权威变更日志。在线访问：modelmeter.xyz。

这是做什么的

一份机器可读、经来源核验的记录，涵盖模型层的所有变更：带有弃用日期和迁移目标的弃用、稳定 ID 背后的静默模型替换、价格变更、发布，以及三年的价格历史记录和成本工具。每个事件都附有来源及其原文引述（大多数还附有网页存档快照）、核验状态（unverified → 经人工审核的 verified），更正也绝不会悄无声息——correction 事件会指向其取代的内容。

本项目主要供 AI Agent 以编程方式调用，其次供人类通过仪表板使用。可通过三种方式访问：返回 JSON 的纯 GET URL、任何可调用工具的 Agent 都能连接的远程 MCP 服务，以及基于相同端点构建的可视化仪表板。核心优势：简洁的 URL、稳定的 JSON 契约、OpenAPI 规范和便于发现的 llms.txt 文件。该领域的大多数网站都是 Agent 无法使用的、严重依赖 JS 的 SPA；Modelmeter 则反其道而行。

端点

• GET /estimate?model=X&input=N&output=M — 估算假设调用的 token 成本，包括转售模型与上游价格的对比
• GET /models — 当前模型目录，支持筛选
• GET /model?id=X — 单个模型的统一信息卡：标准化价格、能力（上下文窗口、视觉、推理、标签）、可用性、转售加价，以及价格历史摘要（发布时与当前价格、变化百分比、历史最低价／最高价）
• GET /check?models=gpt-4o,claude-sonnet-4-6 — **我的技术栈正常吗？**逐个模型给出判定：已安排的退役及剩余天数和迁移目标、已退役模型、破坏性变更，或状态正常
• GET /deprecations — 按模型列出的退役条目：哪些模型将在何时退役，以及剩余准备时间和迁移目标
• GET /feed.xml / GET /feed.json — 提供破坏性变更和需要采取行动的事件的 RSS 2.0 / JSON Feed 1.1
• GET /events — 权威变更日志：弃用、价格变更、发布和相关市场事件；每个事件均包含 severity（breaking | action_required | informational）、announced_at／effective_at 日期、带引述的来源，以及核验 status。筛选条件：provider、type、model、severity、since、until、status
• GET /history — 按模型记录的历史价格时间序列，支持筛选
• GET /pricing.json — 原始价格快照
• GET /events.json — 原始事件快照
• GET /history.json — 原始历史时间序列

完整规范请参阅 public/openapi.yaml。

GitHub Action

当仓库依赖的模型已弃用、即将退役或已退役时，使 CI 失败：

- uses: modelmeters/modelmeter/actions/check@main
  # with:
  #   models: "gpt-4o, claude-sonnet-4-6"   # optional — otherwise the repo is scanned for known model ids
  #   fail-on: breaking                      # breaking (default) | retired | none
  #   warn-days: "120"                       # sunsets within N days fail; beyond N warn

该 Action 会在仓库中扫描已知模型 ID（目录以及弃用事件中提及的所有模型，包括带连字符和带点号的拼写形式），调用 /check，标注每个受影响模型所在的确切 file:line，生成包含迁移目标的作业摘要表，并根据 fail-on 策略以非零状态退出。

MCP 服务

Modelmeter 也是一个远程 MCP 服务，因此任何可调用工具的 Agent（Claude、Hermes 等）都能通过 Streamable HTTP 传输原生调用；无需身份验证，也无需安装：

https://modelmeter.xyz/mcp

工具：check_model_dependencies、list_deprecations、estimate_cost、get_model、list_models、get_price_history、list_events。可先使用 list_models 查找 ID，再调用 get_model 或 estimate_cost。MCP 工具返回的数据与上述 REST 端点相同，可按运行环境偏好选用。

数据集

• pricing/ — 各提供商模型当前及历史价格
• events/ — 事件记录（架构 2.0.0）：弃用、价格变更、发布和市场事件，包含一手来源引文、原文引述及验证状态

每条记录都包含 last_verified 日期。pricing/snapshots/ 中的每日快照会不断累积历史记录。错误定价是根本性风险——架构要求在提供记录前必须经过明确的人工验证。

贡献

发现价格变更？请提交 PR，更新 pricing/current.json，提供新价格、更新后的 last_verified 日期和来源 URL。

发现有意义的 AI 市场事件？请在 events/current.json 中添加一条记录，并附上一手来源引文以及 verified: true。

提供商定价页面发生变更时，自动化流程会创建 issue。欢迎认领 issue 并提供帮助。

许可证

MIT——请参阅 LICENSE。