🫘 GoldBean

⚡ Live Demo — Try it Now

Click a button below to call a real GoldBean API endpoint. No sign-up required!

🌍 The Problem We Solve

Baidu has world-class AI APIs — especially for Chinese language processing (OCR, NLP, ASR, TTS). But using them directly requires:

• 🇨🇳 A Chinese phone number for account registration
• 🪪 Chinese ID card for real-name verification
• 🏢 A Baidu Cloud account with payment setup
• 💰 Minimum monthly spend requirements

GoldBean removes that barrier. Same Baidu AI APIs, accessible globally with just PayPal, Alipay, or USDC. No Chinese ID, no Baidu account, no subscription.

🤖 Baidu AI Endpoints — The Core

These are the APIs you can't easily get outside China. Each one is powered by Baidu's production-grade AI models.

🚀 Quick Start — 30 Seconds

# Baidu OCR — extract text from Chinese image
curl "https://goldbean-api.xyz/paid/baidu-ocr?url=https://example.com/chinese-text.png" \
  -H "x-user-id: YOUR_API_KEY"

# Get weather (free)
curl "https://goldbean-api.xyz/weather-now?city=London"

# BTC price (free)
curl "https://goldbean-api.xyz/btc-price"

# ETH gas (free)
curl "https://goldbean-api.xyz/gas"

# Step 1: Get x402 pricing quote
curl -H "Accept: application/x402+json" \
  "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

# Step 2: Sign the 402 challenge with your wallet
# (see x402 tutorial below)

# Step 3: Call with signed payment
curl -H "Authorization: x402 " \
  "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

# Add to your Claude Desktop / Cursor / Windsurf config:
{
  "mcpServers": {
    "goldbean": {
      "command": "npx",
      "args": ["-y", "goldbean-mcp"]
    }
  }
}

# Or install globally:
npm install -g goldbean-mcp

💰 Pricing — Starting at $0.01

No subscription. No monthly fees. Pay only for what you use.

💳 Buy Credits — From $1 (PayPal / Alipay / USDC)

🔐 How x402 Works

x402 is a pay-per-request protocol for HTTP APIs. Instead of API keys or subscriptions, you pay per call using USDC on Base.

Quick x402 Signing Tutorial:

1. Install a wallet
   Use MetaMask or any EVM wallet on Base network. Get USDC on Base.
2. Make an x402 request

   curl -v -H "Accept: application/x402+json" \
     "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

3. Sign the challenge
   The server returns a 402 Payment Required with a X-402-Payment header containing the payment URL. Use your wallet to sign the transaction.

   # Example response header:
   # X-402-Payment: https://goldbean-api.xyz/x402/pay/0x1234...
   # 
   # Send USDC to the contract address returned
   # Include the signed transaction hash as Bearer token

4. Get your data

   curl -H "Authorization: Bearer <signed-tx-hash>" \
     "https://goldbean-api.xyz/paid/weather-now?city=Tokyo"

📚 Resources