# AI Relay

> AI Relay 让用户的 AI（Claude、ChatGPT 等）通过 MCP 调用已接入的产品。产品方（供给方）实现一个 HTTPS 端点 `POST /relay`，接收 HMAC-SHA256 签名的 JSON 信封，再提交一份用 JSON Schema 描述动作的清单。确认、授权、计费都由 Relay 判定，供给方代码不做计费。

如果你是在帮一个产品接入 AI Relay 的编码 AI：先读接入总览，对照「开始前准备」向用户一次问齐缺的信息（新产品还是给已接入的产品加功能、仓库、部署通道、HTTPS 地址、secret 放哪、测试买家），选档位后从起步模板改起，写完用接入验收工具（@dreamcavy/ai-relay-conformance，未发布前从公开仓库源码构建）跑到全绿。一个账号可以接多个产品：每个产品单独开一个供给方，各用各的 supplier_id、secret、端点地址、清单和余额（接入总览「一个账号接多个产品」）。完成的标准是供给方后台「上线状态」5 项全绿，不是审核通过。只能读一个文件时读 llms-full.txt。规范第 15 节是 AI 侧的 MCP，供给方跳过。

## 接入指南

- [接入 AI Relay](https://relay.newbeeai.online/docs)：开始前准备、最短路线、上线要满足的 5 个条件、钱的事、选档位、一个账号接多个产品、包的发布状态
- [起步模板](https://relay.newbeeai.online/docs/starters)：零依赖、现在就能跑的 L1 和 L2（异步 + 多方案 + 绑定）完整端点，只改业务函数
- [测试隔离与检查清单](https://relay.newbeeai.online/docs/testing)：哪些调用是测试、测试买家和绑定码、必做检查和选做排障
- [L0：从 OpenAPI 导入（零代码）](https://relay.newbeeai.online/docs/l0)：从 OpenAPI 导入，Relay 托管适配器替你转发
- [L1：一个端点（同步）](https://relay.newbeeai.online/docs/l1)：清单、POST /relay、验签、幂等、错误码，Node 和 Python SDK 示例，本机自测
- [L2：异步与多方案](https://relay.newbeeai.online/docs/l2)：接单、回调、补拉、取消、多方案
- [账号绑定](https://relay.newbeeai.online/docs/binding)：一次性绑定码和 binding.verify
- [计费与结算](https://relay.newbeeai.online/docs/billing)：手续费与用户金额、扣费时刻、余额、争议、质量

## 协议

- [RSP 1.0：Relay Supplier Protocol](https://relay.newbeeai.online/docs/rsp-1.0)：协议全文：信封、响应、回调、错误码、签名；供给方跳过第 15 节
- [JSON Schema](https://github.com/fengdejiyihi/ai-relay-protocol/tree/main/packages/protocol/schemas)：机器可读定义，和文字不一致时以它为准
- [公开仓库](https://github.com/fengdejiyihi/ai-relay-protocol)：规范、Schema、SDK、接入验收工具、参照实现

## Optional

- [llms-full.txt](https://relay.newbeeai.online/llms-full.txt)：上面全部文档加 Schema 和示例清单，拼成一个文件