用户付费的 AI 基础设施。接入 Echo 后，用户自行支付使用费用——您无需垫付任何成本。

告别在垫付 API 费用、复杂的 BYOK 流程或从零构建计费系统之间的艰难抉择。

阅读文档 | 在线演示 | 查看我们的公告

问题所在

构建 AI 应用时，开发者不得不在以下几种方案中做出选择：

方法	开发者成本	用户体验	收入模式
BYOK	无（但无收入）	复杂的密钥管理	无
开发人员 API 密钥	不可预测的资金消耗	简单	需要计量与计费
向最终用户收费	数周搭建基础设施	简单	认证 + Stripe + 计量

Echo 则一举解决了这三大难题。

Echo 的工作原理

只需将现有的 AI SDK 导入替换为 Echo。用户只需一次身份验证，即可获得账户余额并自行支付使用费用。您只需设定加价比例，便可自动获得收益。

改造前：

// 方案一：由您自己垫付费用
import { openai } from '@ai-sdk/openai';
import { generateText } from 'ai';
const response = await generateText({
  model: openai('gpt-5'),
  'YOUR-API-KEY',
  prompt: '...'
});

改造后：

// 用户付费，您赚取差价，无需任何基础设施
import { useEchoModelProviders } from '@merit-systems/echo-react-sdk';
import { generateText } from 'ai';

const { openai } = useEchoModelProviders();
const response = await generateText({
  model: openai('gpt-5'),
  prompt: '...',
});

快速开始

pnpx echo-start@latest

此命令会创建一个预配置好 Echo 的新应用，两分钟内即可上线。

为什么选择 Echo？

无需托管成本 - 用户通过 Echo 直接向服务提供商付款。您无需代理请求或垫付账单。

更佳的用户体验 - 一次 OAuth 登录即可取代复杂的 BYOK 流程。用户可在所有 Echo 应用中共享同一账户余额。

即时收益 - 您只需设置加价百分比，每次调用都会自动为您带来利润。

零基础设施 - 无需支付处理、用量跟踪或密钥验证。这一切都由 Echo 自动完成。

核心组件

• Echo Control：用于 echo.merit.systems 的 Next.js 应用。包含托管站点和 API 路由。
• Echo Server：用于 router.echo.merit.systems 的 Express 服务器。负责代理和计量来自客户端的 LLM 请求。

SDK

• Echo TS SDK：所有框架特定 SDK 的基础 TypeScript SDK。
• Echo Next.js SDK：用于简单集成 Next.js 15+ App Router 的 SDK。
• Echo React SDK：用于简单集成 React 客户端 SPA 的 SDK。

示例

• Echo Next.js 示例
• Echo React SDK 示例

模板

使用 echo-start 快速入门：

pnpx echo-start gen-ai-app

可用模板：

• next - 包含 Echo 的 Next.js 应用
• react - 包含 Echo 的 Vite React 应用
• next-chat - 包含 Echo 和 Vercel AI SDK 的 Next.js 聊天机器人
• assistant-ui - 包含 Echo 和 Assistant UI 的 Next.js 应用
• echo-cli - 使用 Echo 进行 AI 聊天的 CLI 工具（支持 API 密钥和加密钱包）

或者运行 npx echo-start my-app 进行交互式选择。

注意： CLI 模板（echo-cli）需要从仓库手动安装，因为它是一个命令行工具而非 Web 应用程序。详情请参阅 模板 README。

开发

填写 packages/app/control/.env 和 packages/app/server/.env 文件。然后...

• pnpm i
• pnpm dev

Echo 快速上手指南

Echo 是一款“用户付费”模式的 AI 基础设施工具。它允许开发者将 AI API 成本直接转嫁给最终用户，开发者无需预付费用，只需设置加价比例即可自动获得收益。通过替换标准的 AI SDK 导入，即可实现用户认证、余额管理和自动计费。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• Node.js: 建议安装最新 LTS 版本（推荐 v18+ 或 v20+）。
• 包管理器: 推荐使用 pnpm（Echo 官方示例主要基于 pnpm），也可使用 npm 或 yarn。
• 框架支持: 支持 Next.js (App Router), React (Vite/SPA) 等主流前端框架。
• AI SDK: 项目需依赖 ai 包（Vercel AI SDK）或其兼容库。

提示：国内开发者若遇到 npm/pnpm 源连接缓慢问题，建议切换至国内镜像源：

pnpm config set registry https://registry.npmmirror.com

安装步骤

Echo 提供了命令行工具 echo-start，可一键生成预配置好的项目模板。

方式一：交互式创建（推荐）

运行以下命令，根据提示选择适合你的模板（如 Next.js, React, Chatbot 等）：

pnpx echo-start@latest

方式二：指定模板创建

如果你已知需要的模板类型，可以直接指定项目名称和模板类型。例如创建一个名为 gen-ai-app 的 Next.js 应用：

pnpx echo-start gen-ai-app

可用模板列表：

• next: 集成 Echo 的 Next.js 应用
• react: 集成 Echo 的 Vite React 应用
• next-chat: 集成 Echo 和 Vercel AI SDK 的 Next.js 聊天机器人
• assistant-ui: 集成 Echo 和 Assistant UI 的 Next.js 应用
• echo-cli: 基于命令行的 AI 聊天工具（需手动安装，见仓库说明）

本地开发运行

如果你克隆了源码或需要手动配置环境变量，请按以下步骤操作：

1. 填写环境变量文件：
   • packages/app/control/.env
   • packages/app/server/.env
2. 安装依赖并启动开发服务器：

pnpm i
pnpm dev

基本使用

Echo 的核心用法非常简单：只需将原有的 AI SDK 导入替换为 Echo 提供的 Hook，即可让用户为自己的使用量付费，而你自动赚取设定的加价利润。

代码对比

修改前（传统模式）： 你需要自己管理 API Key 并承担所有费用。

// Option 1: Front costs yourself
import { openai } from '@ai-sdk/openai';
import { generateText } from 'ai';
const response = await generateText({
  model: openai('gpt-5'),
  'YOUR-API-KEY',
  prompt: '...'
});

修改后（Echo 模式）： 用户通过 OAuth 登录并充值，你无需处理支付和密钥验证。

// Users pay, you earn markup, zero infrastructure
import { useEchoModelProviders } from '@merit-systems/echo-react-sdk';
import { generateText } from 'ai';

const { openai } = useEchoModelProviders();
const response = await generateText({
  model: openai('gpt-5'),
  prompt: '...',
});

核心优势

• 零基础设施成本：无需构建计费系统、无需对接 Stripe、无需验证 Key。
• 用户体验优化：用户只需一次 OAuth 登录，即可在所有 Echo 应用中共享余额，避免了复杂的 "自带密钥" (BYOK) 流程。
• 即时收益：在控制台设置加价百分比，每次 Token 消耗都会自动为你产生利润。

更多详细文档请访问 Echo Docs 或查看 在线演示。