mapleai-mcp

MapleAI — 使用 x402 按请求付费的 GPT、Claude 和 Agent API

兼容 OpenAI 的 GPT、原生支持 Anthropic 的 Claude 聊天、多步 Agent 执行、图像、音频、X（Twitter）情报、嵌入和结构化决策 API，统一通过一个端点提供。按请求付费层无需账户、订阅或 API 密钥——Agent 通过 x402 协议以 USDC 按调用付费。也提供预付费 API 密钥，供偏好使用令牌预算而非逐请求付款的客户端选择。

在线端点

网络	基础 URL	结算服务
Solana	https://sol.mapleai.shop	Coinbase CDP
Base	https://base.mapleai.shop	Coinbase CDP
Polygon	https://polygon.mapleai.shop	Coinbase CDP
Arc	https://arc.mapleai.shop	本地

预付费密钥端点（共用）：https://mapleai.shop/v1

模型和定价

GPT（每 1M 个令牌）

模型	输入	输出
openai/gpt-5.6-sol	$2.80	$14.00
openai/gpt-5.6-terra	$1.40	$8.40
openai/gpt-6-luna	$0.07	$0.35
openai/gpt-6-sol	$1.40	$7.00

请求费用按已计数的输入令牌数 × 输入费率 + 请求的输出令牌数 × 输出费率计算，另加网络结算费（约 $0.001；确切金额始终会显示在 402 挑战中）。失败的调用（HTTP ≥ 400）会取消，不会结算。

Claude（每 1M 个令牌）

原生 Anthropic Messages API，端点为 POST /v1/messages（支持系统提示词、内容块、SSE 事件、必需的 max_tokens；系统提示词按输入令牌计费）。也可通过兼容 OpenAI 的 /v1/chat/completions 调用。

模型	输入	输出
anthropic/claude-haiku-4-5	$0.50	$2.50
anthropic/claude-sonnet-4-5、anthropic/claude-sonnet-4-6	$1.50	$7.50
anthropic/claude-sonnet-5、anthropic/claude-sonnet-5-5	$1.00	$5.00
anthropic/claude-opus-4-6、anthropic/claude-opus-4-7、anthropic/claude-opus-4-8、anthropic/claude-opus-5	$2.50	$12.50
anthropic/claude-opus-5-5	$2.00	$10.00

Agent 执行

POST /v1/agents/execute — 多步 Agent 循环（推理 → 调用工具 → 最终回答），响应兼容 Cluster Protocol。可选 SSE 步骤流式传输，设置 "stream": true 即可（运行工具时发送 step 事件，最终结果通过 done 发送）。内置工具：确定性的 calculator、data_analysis（对最多 500 个数字进行统计）、无需密钥的 web_search（Exa）和 fetch_url。每步超时会返回部分结果，而非直接返回 502。

引擎	基础费用	每步费用	上游模型
agents/oss-20b	$0.002	$0.0005	gpt-oss-20b（经济档）
agents/gpt-6-sol	$0.004	$0.004	gpt-6-sol（高端档）

按费用上限收费——基础费用 + max_steps × 每步费用（另加工具费用上限），与聊天的 max_tokens 类似；每项任务最多 20 步。

图像（每张）

模型	价格
gpt-image-2	$0.02
gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst	$0.04
grok-imagine-image	$0.045
gpt-image-2-2k	$0.09
gpt-image-2.5-sunburst-2k	$0.22

POST /api/v1/images/generations 和 POST /api/v1/images/image2image（编辑 PNG/JPEG/WebP 数据 URI，最大 10 MB）。在 Solana 上，这些路由会预先结算（图像生成耗时可能超过 Solana 区块哈希的有效期），并在同一已付费请求中重试上游的暂时性故障。

音频（按请求计费）

模型	端点	价格
tts-1、tts-1-hd（Gemini flash/lite）、orpheus-english、orpheus-arabic（Groq Orpheus）	POST /v1/audio/speech	$0.015
whisper-1（Gemini 3.5）、whisper-large-v3、whisper-large-v3-turbo（Groq）	POST /v1/audio/transcriptions	$0.006

TTS 接受 JSON {model, input, voice?, response_format?}，并返回 WAV 流；OpenAI 语音预设会映射到 Gemini 语音，orpheus 模型使用其专属的情感语音（en：autumn/diana/hannah/austin/daniel/troy，ar： fahad/sultan/noura/lulwa/aisha/abdullah；支持 [laughs] 风格标签和实际的 speed）。STT 接受 multipart file + model 或 JSON base64，最大 25 MB；whisper-large-v3* 还支持 verbose_json 单词时间戳以及 srt/vtt。 响应包含 x-audio-upstream 和 x-fallback-used 标头——当主供应商故障时，请求会在 同一笔付款内切换到备用供应商（此时 TTS 使用的语音会有所不同）。

X（Twitter）情报

通过 Grok x_search 搜索实时 X 内容并进行分析：

端点	功能	价格公式
POST /v1/x/search	附带帖子引用的摘要回答	$0.015 + $0.0015 × max_results（使用 include_web 时另加 $0.01）
POST /v1/x/digest	在回溯时间范围内汇总特定账号的内容	$0.02 + $0.005 × 账号数
POST /v1/x/sentiment	情绪判断、评分、分布和驱动因素	$0.025 + $0.0015 × 证据帖子数 + $0.005 × 天数
POST /v1/x/factcheck	附带正反证据的声明判定	$0.03 + $0.002 × 来源数
POST /v1/x/profile	个人资料档案：简介、关注者、主题、标记	$0.02 + $0.015 × 账号数
POST /v1/x/media	理解帖子媒体中的图像/视频	$0.02 + $0.002 × 结果数

Jev 结构化决策

POST /jev — jev-latest，每 1M 输入令牌 $0.06，输出免费。SystemOne 协议：发送 model、state 和命名的 questions（noul、choice 或 带有 instructions 的 score），然后从响应中读取 answers。

免费套餐

POST /v1/embeddings — 免费使用 NVIDIA nvidia/nemotron-3-embed-1b（2048 维）。将 input 作为字符串或最多包含 128 个字符串的数组发送； model 为可选项，且会被忽略。

POST /v1/free/chat/completions — 免费使用 nvidia/gpt-oss-20b 聊天， 按 Agent 限流（10 分钟内 10 次请求，每天 100 次）。

快速开始

# 1. Any request without payment returns HTTP 402 with the exact quote
curl -i https://base.mapleai.shop/v1/chat/completions \
  -H 'content-type: application/json' \
  -d '{"model":"openai/gpt-6-luna","messages":[{"role":"user","content":"Hello"}],"max_tokens":64}'

# 2. An x402-aware client signs the challenge and retries automatically

import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });

const first = await fetch(url, { method: "POST", headers, body });
const challenge = JSON.parse(Buffer.from(first.headers.get("payment-required"), "base64").toString());
const payment = await client.createPaymentPayload(challenge);
const paid = await fetch(url, {
  method: "POST",
  headers: { ...headers, "payment-signature": Buffer.from(JSON.stringify(payment)).toString("base64") },
  body,
});

可运行的端到端演示（免费嵌入 → 付费 GPT 回答）位于 examples/embeddings-to-chat/，也可在线访问 https://base.mapleai.shop/examples/embeddings-to-chat/。

正在构建 Agent？请 Fork agent-starter/ 模板——其中包含面向 Agent 客户端的仓库说明（CLAUDE.md/AGENTS.md）、MCP 接线配置、 完整的付费场景脚本（免费嵌入 → 预付费 tap → 预付费聊天），以及涵盖全部四个网关的免费 CI 冒烟测试。

预付费 API 密钥

只需一次 x402 付款，即可为一种 GPT 或 Claude 模型购买预付费 bearer 密钥，或购买 Jev 输入令牌包：

curl https://base.mapleai.shop/prepaid/codes \
  -H 'content-type: application/json' \
  -d '{"model":"openai/gpt-6-luna","tokens":100000}'

预算按 100 000 个令牌为一个阶梯，从 100 000 到 1 000 000；价格按模型输入费率加结算费计算：

模型	0.1M 套餐	1M 套餐
openai/gpt-5.6-sol	$0.28	$2.80
openai/gpt-5.6-terra	$0.14	$1.40
openai/gpt-6-luna	$0.007	$0.07
openai/gpt-6-sol	$0.14	$1.40
anthropic/claude-haiku-4-5	$0.05	$0.50
anthropic/claude-sonnet-5	$0.10	$1.00
anthropic/claude-opus-5	$0.25	$2.50
jev-latest（仅输入令牌，输出免费）	$0.006	$0.06

GPT 和 Claude 密钥在 POST /prepaid/v1/chat/completions 处扣费（适用于子域名以及共享地址 https://mapleai.shop/v1，与 OpenAI 兼容）； Jev 套餐在 POST /prepaid/v1/jev 处扣费。免费查看用量和状态：

curl https://mapleai.shop/v1/prepaid/status \
  -H "Authorization: Bearer oms_buy_..."

发现

• GET /v1/models — 免费模型目录，包含实时定价
• GET /.well-known/x402 — x402 资源清单
• GET /openapi.json — OpenAPI 3.1 规范
• GET /llms.txt、GET /AI-AGENTS.md — 面向 Agent 的文档
• GET /developers — 开发者指南，包含示例

仓库结构

• src/ — x402 网关（Express、TypeScript，在 tsx 下运行）
• admin/ — 基于 OmniRoute 的管理应用：提供商连接、组合、预付费密钥签发和仅限钱包（SIWE）的仪表板
• examples/ — 可运行的客户端示例
• packages/mapleai-mcp/ — 本地 stdio MCP 服务（免费模型目录、嵌入和预付费状态；付费 GPT 和 Claude 聊天、Jev、Agent 执行，以及通过本地 x402 签名购买的预付费密钥包；购买的密钥可通过 prepaid_chat 在服务端内消费，无需钱包）
• tools/ — 支付和上游测试脚本
• deploy/ — VDS 上使用的 systemd 单元和 Apache 虚拟主机

开发

npm install
cp .env.example .env   # fill in UPSTREAM_API_KEY, PAY_TO, model prices
npm run typecheck
npm start              # listens on PORT (default 4021)

必需的环境变量：UPSTREAM_API_KEY、PAY_TO、MODEL_PRICES、MODEL_MAPPING。 可选功能通过各自的密钥启用（IMAGE_UPSTREAM_API_KEY、 NVIDIA_API_KEY、JEV_UPSTREAM_API_KEY、PREPAID_ISSUER_TOKEN、……）——完整列表请参见 .env.example。