nano-banana-blockrun

Nano Banana by BlockRun

Generate images using Google's Nano Banana model via BlockRun's x402 API. Pay-per-request with USDC on Base - no API keys needed.

Setup (one-time)

1. Install the SDK:

   pip install blockrun-llm
   

2. Get USDC on Base network:

   • Bridge from Ethereum: https://bridge.base.org
   • Or buy directly on Coinbase and withdraw to Base
   • You need ~$1-5 USDC to start generating images

3. Set your wallet private key:

   # Copy .env.example to .env and add your key
   cp .env.example .env
   
   # Or export directly
   export BLOCKRUN_WALLET_KEY=0x...
   

Network: Base (Chain ID: 8453) Payment: USDC only

Generate an Image

from blockrun_llm import ImageClient

client = ImageClient()
result = client.generate("a cute cat wearing a space helmet")
print(result.data[0].url)

Or use the script:

python scripts/generate.py "a cute cat wearing a space helmet"

# Save to a specific directory
python scripts/generate.py "a cute cat" "google/nano-banana" "/path/to/save"

# Or use OUTPUT_DIR environment variable
OUTPUT_DIR=/path/to/save python scripts/generate.py "a cute cat"

Available Models

How It Works

1. Your request goes to BlockRun API (https://blockrun.ai)
2. BlockRun returns HTTP 402 Payment Required
3. SDK signs USDC payment locally (key never leaves your machine)
4. Only the signature is sent to server
5. Image is generated and returned

No API keys, no subscriptions - just crypto micropayments.

Security

Your private key NEVER leaves your machine.

The SDK uses EIP-712 typed data signing locally. Only the signature is transmitted. Same security as signing any MetaMask transaction.

Links

• BlockRun
• x402 Protocol
• PyPI Package