pydantic/genai-prices

它是什么

GenAI Prices 是一个开源库，用于收集、整理并提供数十种大型语言模型 (LLM) 推理 API 的定价信息。它让开发者能够查询在 OpenAI、Anthropic、Gemini、Azure 等供应商上，一个 Token、一次请求或特定上下文长度的成本。

为何重要

当您开发 AI 产品时，通常需要估算或控制支出。供应商以不同的格式发布价格（有些每日变动、有些采用分级费率、有些提供历史价格修订）。手动更新这些数据容易出错。GenAI Prices 将数据集中化，标准化模型与供应商标识符，并提供程序化的方式来计算成本，协助团队编制预算、比较供应商并发现价格异常。

核心功能

• 广泛的供应商覆盖 – 40 多家供应商、1,500 多种模型，并通过 YAML 文件将供应商特定的 ID 映射至通用架构。
• 历史与变动定价 – 支持随时间变动的价格以及每日变动费率（例如 Deepseek 的非高峰定价）。
• 分级定价 – 处理成本取决于上下文大小的模型（例如 Gemini 的大上下文分级）。
• 差异检测 – 用于将库数据与其他来源进行比较的工具。
• 多语言 SDK – 提供 Python、JavaScript/TypeScript 和 Go 的现成包与 CLI。
• 数据文件 – 可下载并在不使用 SDK 的情况下使用的静态 JSON 注册表（完整版与精简版）。
• 未来 API 与网页 UI – 路线图包含用于即时查询的托管服务。

适用对象

• 开发 LLM 应用程序的开发者，需要估算 Token 成本以进行预算编制或为自己的服务定价。
• 产品经理，比较供应商以选择最具成本效益的方案。
• 运营/财务团队，希望审计云端 LLM 支出并捕捉意外的价格变动。
• LLM 供应商，可以贡献自己的定价文件以保持注册表的准确性。

入门指南

1. 安装 SDK – 例如 pip install genai-prices (Python) 或 npm i genai-prices (JS/TS)。
2. 加载价格注册表 – 包内含 JSON 数据；您也可以从 prices/ 目录下载原始文件。
3. 查询模型 – 使用供应商名称、模型 ID 和 Token 数量调用辅助函数以获取成本估算。
4. 使用 CLI – genai-prices lookup openai/gpt-4 1000 可打印 1,000 个 Token 的成本。
5. 贡献 – 新增或更新供应商的 YAML 文件，运行基准测试工作流程，并提交 PR。

限制与注意事项

• 尽力而为的数据 – 价格是从公开来源抓取/整理的；它们可能落后于供应商的更新，或遗漏特定地区的折扣。
• 尚无实时 API – 该库目前依赖静态 JSON 文件；未来计划提供在线 API。
• 仅限推理定价 – 训练成本、微调费用或自定义企业合同不在范围内。

---

GenAI Prices 是 Pydantic Stack 的一部分，该堆栈还包含 Pydantic AI（类型安全代理框架）、Logfire 可观测性工具以及 AI 网关。