@dassi_ai/relay

中文文档
0.1.0发布于 2026/03/25MITTypeScriptES Module零依赖近 30 天下载 5682

通过 Relay LLM 代理的路由 pi-ai 模型

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 自定义中继 URL
  4. API 密码
  5. relay(modelOrId, options?)
  6. detectProvider(modelId)
  7. 常数
  8. 如何运作

@dassi/ 转发

路线 皮爱 模型通过 中继 LLM 代理服务器 管理下的账单.

安装

npm install @dassi/relay @mariozechner/pi-ai

使用量

import { relay } from '@dassi/relay';
import { streamSimple } from '@mariozechner/pi-ai';

// Get a Relay-routed model from a model ID
const model = relay('claude-sonnet-4-5');

// Or reroute an existing pi-ai Model
import { getModel } from '@mariozechner/pi-ai';
const relayModel = relay(getModel('anthropic', 'claude-sonnet-4-5'));

// Stream with your Supabase JWT as the API key
const stream = streamSimple(model, context, { apiKey: supabaseJwt });

自定义中继 URL

对于自办的转发实例:

const model = relay('gpt-5.4', { relayUrl: 'https://my-relay.example.com' });

API 密码

relay(modelOrId, options?)

返回一个pi-ai Model 与 baseUrl 指向中继.

  • modelOrId数字 : string (型号ID像 'claude-sonnet-4-5')或现有的pi-ai Model
  • options.relayUrl: 覆盖默认中继 URL

detectProvider(modelId)

从模型ID中检测本地供应商: claude-* - > (中文) anthropic, (中文(简体) ), gemini-* - > (中文) google, 否则 - > openai。 。 。 .

常数

  • RELAY_URL — 默认中继代理 URL
  • RELAY_PROVIDERS – 提供方中继端点 URL

如何运作

中继是一个透明的HTTP代理. 它从来不分析或修改请求/答复机构。 这个SDK:

  1. 从模型名称(或模型名称)中检测本地提供者 api 字段)
  2. 从 Pi-ai 注册处获取模型( 使用本地供应商的 SDK)
  3. 覆盖 baseUrl 通过中继器的路由

您的 Supabase JWT 作为 API 键通过 。 中继验证,检查您的预算,在真正的提供者 API 密钥中互换,并转发请求.

版本与发布记录

@dassi_ai/relay 共发布 1 个版本,首次发布于 2026/03/25;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.1.0latest2026/03/257 个月前

关于 @dassi_ai/relay 的常见问题

@dassi_ai/relay 是什么?

通过 Relay LLM 代理的路由 pi-ai 模型

如何安装 @dassi_ai/relay?

在项目目录运行 npm install @dassi_ai/relay,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@mariozechner/pi-ai(>=0.50.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@dassi_ai/relay 支持 TypeScript 吗?

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

@dassi_ai/relay 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dassi_ai/relay 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dassi_ai/relay 可以商用吗?

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

@dassi_ai/relay 的下载量有多少?

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

@dassi_ai/relay 还在维护吗?

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