Skip to content

wuzenghai616-lang/goldbean

Repository files navigation

🫘 GoldBean — 53 Chinese AI Tools via x402 Micropayments

53 Baidu AI endpoints (19 OCR types, ERNIE LLM, TTS, ASR, vision, NLP, translation, search) — pay per call from $0.003 in USDC on Base. No API keys, no signup, no subscription.

API Status x402 Native npm Glama Score License Free Tier

GoldBean is the only Chinese AI multimodal API cluster in the x402 ecosystem. 53 production-ready endpoints powered by Baidu AI — OCR (19 types), image recognition (10 types), ERNIE LLM, TTS, ASR, NLP, translation, face detection, image/video generation, and search. All accessible via MCP protocol with pay-per-call pricing.

No API keys. No signup. No subscription. Pay per call in USDC on Base, or use PayPal/Alipay for prepaid credits. 50 free calls/day per IP.


✨ Key Features

Feature Details
53 AI Endpoints 19 OCR types, 10 image recognition, ERNIE LLM, TTS, ASR, NLP (6 types), translation (28+ languages), face/gesture/body detection, image/video generation, web search
x402 Native Pay $0.003–$0.08 per call with USDC on Base mainnet — 2-second settlement, no KYC
No API Keys x402 payment replaces API keys. Free tier needs nothing — just call the endpoint
Free Tier 50 free API calls/day per IP + 100 credits on registration — no wallet needed
MCP Compatible Works with Cursor, Claude Desktop, Cline, Codex, Continue
PayPal & Alipay Also supported for prepaid credits
Baidu AI Powered Enterprise-grade AI from China's leading AI platform

🚀 Quick Start

Option 1: MCP Server (Cursor / Claude / Cline)

npx goldbean-mcp

Add to your MCP client config:

{
  "mcpServers": {
    "goldbean": {
      "command": "npx",
      "args": ["goldbean-mcp"]
    }
  }
}

Option 2: REST API (curl / any HTTP client)

# Free call — no payment, no API key
curl "https://goldbean-api.xyz/health"

# Paid call — x402 payment (USDC on Base)
curl -X POST "https://goldbean-api.xyz/paid/baidu-ocr" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/document.jpg"}'
# → 402 Payment Required → Pay USDC → 200 OK with OCR result

# Register for 100 free credits
curl -X POST "https://goldbean-api.xyz/paid/user/register" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

📡 API Endpoints

🆓 Free Endpoints (No Payment)

Endpoint Description
GET /health Service health check
GET /.well-known/x402.json x402 payment discovery
GET /.well-known/mcp.json MCP server metadata
GET /openapi.json OpenAPI specification
GET /api/routes Full route registry
GET /api/pricing/plans Pricing plans

💳 Paid Endpoints (x402 / Credits)

OCR — 19 types ($0.005/call)

Tool Description
baidu_ocr General printed text OCR — 20+ languages
baidu_ocr_accurate High-precision OCR for blurry/low-quality images
baidu_ocr_table Structured table extraction
baidu_ocr_idcard Chinese ID card extraction (front + back)
baidu_ocr_handwriting Handwritten Chinese/English text
baidu_ocr_qrcode QR code and barcode decoding
baidu_ocr_bankcard Bank card number and bank name
baidu_ocr_business_license Chinese business license fields
baidu_ocr_webimage OCR for web images with complex backgrounds
baidu_deepseek_ocr VLM-powered OCR for complex layouts
baidu_paddleocr_vl PaddleOCR-VL for tables, formulas, stamps
baidu_qianfan_ocr Custom template-based OCR
baidu_ocr_numbers Number/digit recognition
baidu_ocr_seal Seal/stamp OCR
baidu_ocr_train_ticket Train ticket extraction
baidu_ocr_receipt Receipt/invoice OCR
baidu_ocr_invoice VAT invoice extraction
baidu_ocr_passport Passport field extraction
baidu_ocr_license_plate License plate recognition

LLM — 3 tools ($0.005/call)

Tool Description
baidu_llm_chat ERNIE LLM chat — ernie-4.0-8k, ernie-3.5-8k, ernie-speed-128k
baidu_deepthink ERNIE deep reasoning — multi-step proofs, logical analysis
baidu_vision_chat Vision-language chat — ask questions about images (ERNIE-VL)

Speech — 2 tools ($0.005/call)

Tool Description
baidu_tts Text-to-speech — Chinese/English, 6 voice personas, MP3/WAV
baidu_asr Speech-to-text — Chinese/English, word-level timestamps

Translation — 2 tools ($0.003/call)

Tool Description
baidu_translate 28+ language translation with auto-detect
baidu_translate_pro Enhanced translation with x402 metadata response

Vision — 10 tools ($0.005/call)

Tool Description
baidu_image_recognition General image recognition with Baike entries
baidu_object_detect Multi-object detection with bounding boxes
baidu_landmark Landmark/building identification with GPS
baidu_plant Plant species identification (20,000+ species)
baidu_animal Animal species identification (10,000+ species)
baidu_dish Dish/food recognition with calorie estimation
baidu_logo Brand logo detection and identification
baidu_car Vehicle make/model/year (3,000+ models)
baidu_ingredient Food ingredient identification
baidu_vehicle_detect Vehicle detection and counting — traffic/parking

Face & Body — 4 tools ($0.005/call)

Tool Description
baidu_face_detect Face detection with 10+ attributes (age, gender, emotion)
baidu_face_compare 1:1 face comparison — identity verification
baidu_body_analysis Body attribute analysis — gender, clothing, orientation
baidu_gesture Hand gesture recognition — 20+ gesture types

NLP — 6 tools ($0.003/call)

Tool Description
baidu_nlp Chinese NLP — word segmentation, POS tagging, dependency parsing
baidu_sentiment Sentiment analysis — positive/negative/neutral
baidu_summary Text summarization — abstractive with configurable length
baidu_text_corrector Chinese text error correction
baidu_keyword_extraction Keyword/phrase extraction with relevance ranking
baidu_word_embedding Word-level vector embedding (64-512 dimensions)

Image & Video Generation — 4 tools

Tool Price Description
baidu_image_gen $0.03 Text-to-image — realistic/anime/sketch/oil_painting/3d
baidu_image_edit $0.03 Image editing via text instructions
baidu_video_gen $0.08 Text-to-video generation (MuseSteamer)
baidu_video_query $0.005 Query async video generation task status

Search — 1 tool ($0.005/call)

Tool Description
baidu_search Web search with instant answers and related topics

Embedding & Science — 3 tools

Tool Price Description
baidu_embedding $0.005 Text embedding for semantic search/RAG
baidu_reranker $0.005 Document reranking by query relevance
baidu_helixfold $0.005 Protein 3D structure prediction (AlphaFold-inspired)

💰 Pricing

Plan Price Calls Per Call
Free Tier $0 50/day per IP $0
Starter $5 one-time 500 calls $0.01
Developer Monthly $9.9/month 5,000 calls $0.002
Developer Quarterly $25/quarter 20,000 calls $0.0013
Developer Yearly $89/year 100,000 calls $0.0009

Or pay per call without subscription — starting at $0.003/call in USDC on Base.

Payment methods: x402 USDC (Base mainnet) | PayPal | Alipay

Accepting wallet: 0x7484b0bca25d2ee56e9b0535572d4cf44a047d98 (Base/USDC)


🔧 How x402 Payments Work

1. Agent calls endpoint → 402 Payment Required
2. Wallet signs USDC tx on Base → sends payment payload
3. Server verifies on-chain → serves the data (2-second settlement)

No KYC. No subscription. No credit card. No API keys.

Powered by the x402 protocol — decentralized micropayments for AI agents.


📦 MCP Installation

npm install -g goldbean-mcp

Or use directly:

npx goldbean-mcp

Compatible with: Cursor, Claude Desktop, Cline, Codex, Continue, and any MCP-compatible client.


🏗️ Architecture

┌──────────────┐    HTTPS    ┌──────────────────────┐
│  MCP Client   │ ──────────→ │  GoldBean API Server  │
│  (Claude,     │ ←────────── │  v9.8.0 on VPS       │
│   Cursor,     │    402/200  │  port 9879 + 3099    │
│   Cline)      │             │                      │
└──────────────┘             ├── Baidu AI (53 tools) │
                              ├── x402 USDC (Base)    │
┌──────────────┐             ├── PayPal / Alipay     │
│  REST Client  │──────────→ │── Free tier (50/day)  │
│  (curl/HTTP)  │             └──────────────────────┘
└──────────────┘

🌐 Platform Presence

Platform Status
npm (goldbean-mcp) Published
Glama.ai Active
MCPize Monetized
x402 Bazaar Listed
ScoutGate Registered
Bankr x402 Cloud Deployed (3 endpoints)
awesome-x402 Listed

📖 Documentation


🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

  • Star this repo — it helps others discover GoldBean
  • Report bugs via GitHub Issues
  • Improve documentation
  • Share on social media

📄 License

MIT License — see LICENSE for details.


GoldBean (GB) — Wishing You Good Fortune & Prosperity 🫘

53 Chinese AI tools via x402 micropayments — No API keys, no signup, pay per call from $0.003.