内容
# 🫘 金豆 — 按需付费的 AI API 网关
> **从任何地方访问百度 AI（OCR、翻译、TTS、ASR、LLM）- 无需中国手机号**
[](https://goldbean-api.xyz/health)
[](https://github.com/public-apis/public-apis)
[](https://github.com/punkpeye/awesome-mcp-servers)
[](https://glama.ai/mcp/servers/wuzenghai616-lang/goldbean)
[](https://www.npmjs.com/package/goldbean-mcp)
[](LICENSE)
**金豆** 是一个按需付费的 AI API 网关。访问 **百度 AI 产品**（OCR、TTS、ASR、翻译、NLP、面部检测、图像分析）和 **HelixFold3** 蛋白质结构预测 - 所有这些都通过一个统一的 API，支持 **x402 USDC 微支付**。
**无需订阅。无需 KYC。按次付费。**
---
## ✨ 功能
| 功能 | 详情 |
|---------|---------|
| **23+ API 路由** | OCR、TTS、ASR、翻译、LLM 聊天、面部检测、NLP、图像、HelixFold3 |
| **x402 微支付** | 使用 Base 网络上的 USDC 支付 $0.01-$0.05 每笔 |
| **免费层** | 每个注册用户 20 次免费 API 调用 - 无需钱包 |
| **PayPal 和支付宝** | 也支持预付积分 |
| **MCP 兼容** | 与 Cursor、Claude Desktop、Cline、Codex、Continue 兼容 |
| **百度 AI 驱动** | 来自中国领先 AI 平台的企业级 AI |
| **HelixFold3** | Nature 发表的，AlphaFold3 级别的蛋白质/RNA 结构预测 |
---
## 🤔 为什么选择金豆？
> **需要百度 OCR 但没有中国手机号？**
金豆是海外开发者使用百度 AI API 的最简单方式 **无需中国手机号、实名验证或微信支付**。
- ✅ **无需注册使用百度 API** - 无需中国身份证、实名认证
- ✅ **无需中国手机号使用百度 OCR API** - 只需使用任意邮箱注册
- ✅ **无需 KYC、无需订阅** - 通过 USDC、PayPal 或支付宝按次付费
- ✅ **免费积分开始** - 20 次免费 API 调用，无需钱包
- ✅ **全球可用** - 对外国用户无中国大陆限制
无论您需要百度 OCR 进行文档扫描、百度翻译进行多语言文本还是百度 ASR/TTS 进行语音处理 - 金豆解锁了所有这些，无需注册障碍。
---
## 🚀 快速开始
### 1. 安装 MCP 服务器
```bash
npx goldbean-mcp
```
### 2. 添加到您的 MCP 客户端
**Claude Desktop / Cursor / Continue:**
```json
{
"mcpServers": {
"goldbean": {
"command": "npx",
"args": ["goldbean-mcp"]
}
}
}
```
### 3. 使用免费积分（无需钱包）
```bash
# 注册 20 次免费 API 调用
curl -X POST https://goldbean-api.xyz/paid/user/register \
-H "Content-Type: application/json" \
-d '{"userId": "your-user-id"}'
# 响应: {"freeCredits": 20, "apiKey": "GB_XXXXXX"}
# 使用免费积分调用 API
curl "https://goldbean-api.xyz/paid/baidu-ocr?image=https://example.com/doc.jpg" \
-H "x-user-id: GB_XXXXXX"
```
---
## 📡 API 端点
### 🆓 免费系统端点
| 端点 | 描述 |
|----------|-------------|
| `GET /health` | 服务健康检查 |
| `GET /btc-price` | 比特币实时价格（$） |
| `GET /weather-now?city=Lanzhou` | 任意城市当前天气 |
| `GET /gas` | 以太坊 Gas 价格（Gwei） |
| `GET /.well-known/x402-bazaar` | x402 支付发现 |
| `GET /api/routes` | 完整路由注册 |
### 🎯 百度 AI 端点（按次付费）
| 端点 | 价格 | 描述 |
|----------|:-----:|-------------|
| `GET /paid/baidu-ocr` | $0.01 | 普通文本 OCR |
| `GET /paid/baidu-ocr-accurate` | $0.02 | 高精度 OCR |
| `GET /paid/baidu-idcard` | $0.02 | 身份证识别 |
| `GET /paid/baidu-tts?text=...` | $0.01 | 文本转语音（中文） |
| `GET /paid/baidu-translate?text=...` | $0.01 | 多语言翻译 |
| `GET /paid/baidu-llm-chat?prompt=...` | $0.03 | ERNIE 聊天（GPT 类 LLM） |
| `GET /paid/baidu-asr?audio=...` | $0.03 | 语音转文本 |
| `GET /paid/baidu-image-recognition?image=...` | $0.02 | 对象/场景识别 |
| `GET /paid/baidu-image-enhance?image=...` | $0.02 | 图像增强 |
| `GET /paid/baidu-face-detect?image=...` | $0.02 | 面部检测与分析 |
| `GET /paid/baidu-body-analysis?image=...` | $0.02 | 身体/手势分析 |
| `GET /paid/baidu-nlp?text=...` | $0.02 | NLP（词法、情感等） |
| `GET /paid/baidu-helixfold?seq=...` | $0.05 | 蛋白质结构预测 |
### 💳 账户与支付
| 端点 | 描述 |
|----------|-------------|
| `POST /paid/user/register` | 注册 20 次免费积分 |
| `GET /paid/plans` | 预付计划与定价 |
| `POST /paid/paypal/create-order` | 创建 PayPal 支付 |
| `POST /paid/paypal/capture` | 捕获 PayPal 支付 |
| `POST /paid/alipay/create-order` | 创建支付宝支付 |
| `GET /paid/alipay/query` | 查询支付宝订单状态 |
---
## 💰 x402 支付如何工作
```
1. 代理调用端点 → 402 支付要求
2. 钱包在 Base 上签署 USDC 交易 → 发送支付负载
3. 服务器验证链上 → 提供数据
```
**无需 KYC。** **无需订阅。** **无需信用卡。**
由 [x402 协议](https://x402.org) 提供支持 - 面向 AI 代理的去中心化微支付。
**接受钱包：** `0x7484b0bca25d2ee56e9b0535572d4cf44a047d98` （Base/USDC）
---
## 🏗️ 架构
```
┌──────────────┐ HTTPS ┌──────────────────────┐
│ MCP 客户端 │ ──────────→ │ 金豆 API 服务器 │
│ (Claude, │ ←────────── │ v8.0.0 在 VPS 上 │
│ Cursor, │ 402/200 │ 端口 9879 │
│ Cline) │ │ │
└──────────────┘ ├── 百度 AI（OCR/TTS） │
├── CoinGecko（BTC） │
┌──────────────┐ ├── Etherscan（Gas） │
│ 网络浏览器 │──────────→ │── HelixFold3 │
│ (curl/REST) │ │── PayPal/支付宝 │
└──────────────┘ └──────────────────────┘
```
---
## 🏆 平台存在
| 平台 | 状态 | 链接 |
|----------|--------|------|
| **public-apis** (39.8k⭐) | ✅ 已列出 | [查看](https://github.com/public-apis/public-apis) |
| **awesome-mcp-servers** (76k⭐) | ✅ 已列出 | [查看](https://github.com/punkpeye/awesome-mcp-servers) |
| **Glama.ai** | ✅ 活跃 | [分数 →](https://glama.ai/mcp/servers/wuzenghai616-lang/goldbean) |
| **Smithery.ai** | ✅ 已部署 | [查看](https://smithery.ai/servers/wuzenghai616/goldbean) |
| **MCP.Directory** | ✅ 已提交 | 待审核 |
| **npm** | ✅ 已发布 | `goldbean-mcp` |
| **Dev.to** | ✅ 6 篇文章 | [个人资料](https://dev.to/goldbean) |
---
## 📖 文档
- **API 参考：** https://goldbean-api.xyz/openapi.json
- **路由注册：** https://goldbean-api.xyz/api/routes
- **x402 集市：** https://goldbean-api.xyz/.well-known/x402-bazaar
- **定价：** https://goldbean-api.xyz/paid/plans
- **MCP 配置：** https://goldbean-api.xyz/.well-known/mcp.json
---
## 🤝 贡献
我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
### 快速帮助方式：
- ⭐ 给这个仓库点赞 - 它帮助其他人发现金豆
- 🐛 通过 GitHub 问题报告错误
- 📝 改进文档
- 🌐 在社交媒体上分享
---
## 📄 许可证
MIT 许可证 - 请参阅 [LICENSE](LICENSE) 获取详情。
---
**金豆（GB）- 祝你好运与繁荣 🫘** <br>
面向所有人的按需付费 AI。
