@basisoasis/llm-intel

中文文档
1.0.102发布于 2026/11/02MITTypeScriptESM + CJS构建来源已验证近 30 天下载 2494

没有硬编码数据表的OpenRouter成本意识开发源模型能力和定价

中文使用文档
文档目录14 节
  1. 特征
  2. 安装
  3. 使用量
  4. 服务器( U) LLMIntel (中文(简体) )
  5. 独立函数
  6. 浏览器 / SPA ( LLMIntelClient (中文(简体) )
  7. API 参考
  8. LLMIntel (服务器)
  9. LLMIntelClient (浏览器)
  10. getModelInfo(modelId, opts) (独立)
  11. 缓存
  12. 配置
  13. 供应商
  14. 许可证

电话

每个LLM的模型智能.

电话 来源:元数据和定价模型 打开路透社,这样您就可以在不维护自己的数据表格的情况下,查阅能力并计算符号成本.

特征

  • 查看任何模型的能力、上下文窗口和ID定价
  • 精确地计算符号成本(由 bignumber.js(中文(简体) )
  • 两个专有的API:a 服务器客户端 (Fetches from OpenRouter)和(Fetches from OpenRouter) (英语: 浏览器客户端 (阅读预选JSON)
  • 三级缓存:内存 - > 磁盘 - > 网络
  • 生成的完整类型脚本支持 ModelId 类型

查看Demo —

安装

# npm
npm install @basisoasis/llm-intel

# pnpm
pnpm add @basisoasis/llm-intel

# yarn
yarn add @basisoasis/llm-intel

# bun
bun add @basisoasis/llm-intel

使用量

服务器( U)LLMIntel(中文(简体) )

在 Node.js / 服务器侧环境中使用此功能 。 它从 OpenRouter 获取模型数据, 里面有磁盘和内存缓存 .

import { LLMIntel } from "@basisoasis/llm-intel";

// Instantiate a provider client
const client = await LLMIntel.create({ provider: 'openrouter' });

// Resolve a model by ID
const model = await client.getModel(
  'anthropic/claude-4.6-sonnet-20260217'
);

if (!model) throw new Error('Model not found!');

const cost = client.calculateCost(model, {
  inputTokens: 20_000,
  outputTokens: 1700,
});

console.log(client.formatCostResult(cost));
/* {
  inputCost: "$0.06",
  outputCost: "$0.03",
  cacheReadCost: null,
  cacheWriteCost: null,
  imageCost: null,
  requestCost: null,
  totalCost: "$0.09",
  currency: "USD",
  warnings: [],
} */

独立函数

对于一次性检查,而不对客户进行即时检查:

import { getModelInfo } from "@basisoasis/llm-intel";

const result = await getModelInfo("anthropic/claude-3-5-sonnet", {
  provider: "openrouter",
  apiKey: process.env.OPENROUTER_API_KEY,
});

浏览器 / SPA (LLMIntelClient(中文(简体) )

当您已经拥有了型号JSON( 例如获取服务器侧并传递到 SPA, 或在构建时捆绑) 时使用此功能 。 不需要 API 密钥 .

import { LLMIntelClient } from "@basisoasis/llm-intel/client";

// Hydrate from a URL your server exposes
const client = new LLMIntelClient({
  models: "/api/models", // returns ModelsResult JSON
  cacheTtl: 5 * 60 * 1000, // 5 minutes
});

// Or hydrate statically from a pre-loaded array
const client = new LLMIntelClient({ models: modelDataArray });

const model = await client.getModel("google/gemini-2.5-pro");
if (!model) throw new Error('Model not found!');

const cost = client.calculateCost(model, {
  inputTokens: 2000,
  outputTokens: 800,
});

console.log(client.formatCost(cost.inputCost));  // $0.0025
console.log(client.formatCost(cost.outputCost)); // $0.008
console.log(client.formatCost(cost.totalCost));  // $0.01

API 参考

LLMIntel (服务器)

方法说明
LLMIntel.create(opts)创建有效的客户端实例 。 验证前面的配置 .
client.getModels()返回所有可用的模型( E)ModelsResult) (中文(简体) ).
client.getModel(modelId)以 ID 返回单一模式,或 null 如果找不到的话.
client.calculateCost(model, tokens, currency?)计算迅速/完成/总费用.
client.formatCost(amount, currency?)格式 a BigNumber 作为货币字符串(例如:. "$5.12") (中文(简体) ).
client.formatCostResult(result)在a中格式化所有行项目 CostResult 用于字符串.

LLMIntelClient (浏览器)

一样 getModel, (中文(简体) ), getModels, (中文(简体) ), calculateCost, (中文(简体) ), formatCost,以及 formatCostResult 方法。 。 。 使用 URL 或预装 ModelData[] 阵列.

getModelInfo(modelId, opts) (独立)

在不创建客户端的情况下获取单个模型。 用于无服务器函数或脚本 .

缓存

LLMIntel 使用三级缓存 :

  1. 内存 : 速度最快; 任意, TTL 无效
  2. 磁盘 : 幸存进程重新启动
  3. 网络 : 从 OpenRouter 获取新数据

配置 TTL 通过 cacheTtl 以毫秒计(默认值: 86_400_000 ——24小时.

LLMIntelClient 只使用内存缓存(浏览器中没有磁盘访问).

配置

所有选项都是可选的——库会倒回环境变量后再内置默认.

LLMIntel.create({
  provider: "openrouter",
  openRouterApiKey: process.env.LLM_INTEL_OPEN_ROUTER_API_KEY,
  cacheTtl: 86_400_000,
  cacheDir: ".cache",
});
选项新闻 var默认说明
providerLLM_INTEL_PROVIDER"openrouter"要使用的数据源 。 见 供应商。 。 。 .
openRouterApiKeyLLM_INTEL_OPEN_ROUTER_API_KEY—— 说您的 OpenRouter API 密钥 。 使用时需要 openrouter 供养.
cacheTtlLLM_INTEL_CACHE_TTL86_400_000 (24小时)缓存的模型数据有多长被认为是新鲜的,以毫秒计.
cacheDirLLM_INTEL_CACHE_DIR{cwd}/.cache用于磁盘缓存的目录 .

供应商

目前, 打开路透社 是唯一支持的提供者。 库已设计出一个提供者抽象层,因此未来可以在不突破公共API更改的情况下添加对额外数据源的支持.

提供者状态
打开路透社获支持
其他人员计划数

许可证

麻省理工学院

版本与发布记录

@basisoasis/llm-intel 共发布 100 个版本,首次发布于 2026/05/22;过去 12 个月发布了 100 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.102latest2026/11/025 天前
1.0.1012026/10/308 天前
1.0.1002026/10/2414 天前
1.0.992026/10/2315 天前
1.0.982026/10/2216 天前
1.0.972026/10/2216 天前

关于 @basisoasis/llm-intel 的常见问题

@basisoasis/llm-intel 是什么?

没有硬编码数据表的OpenRouter成本意识开发源模型能力和定价

如何安装 @basisoasis/llm-intel?

在项目目录运行 npm install @basisoasis/llm-intel,或使用 pnpm add / yarn add / bun add。

@basisoasis/llm-intel 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@basisoasis/llm-intel 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@basisoasis/llm-intel 可以商用吗?

@basisoasis/llm-intel 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@basisoasis/llm-intel 的下载量有多少?

根据 npm 官方下载统计,@basisoasis/llm-intel 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,494 次,日均约 83 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@basisoasis/llm-intel 还在维护吗?

最新版本 1.0.102 发布于 2026/11/02(5 天前);至今共发布 100 个版本,其中过去 12 个月发布了 100 个;首次发布于 2026/05/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。