AEON AI Gateway

Co-presented by AEON & SkillBoss — AI Agents pay per-call in USDT on BSC to invoke 200+ AI tool capabilities.

Zero API keys · Zero prepay · x402 protocol pay-per-call · Natural-language driven

🚀 AEON x BNB Chain: AI Agent Campaign

Your AI agent is ready to work — now let it pay.

AEON and BNB Chain are launching the AI Agent Campaign, opening up a native payment rail for autonomous AI agents on BNB Chain. With BNB assets, your agent can now call LLMs, APIs, skills, and compute resources — and settle instantly on-chain.

How it works

Agents pay with BNB-native assets through AEON's infrastructure. Every API call, every model inference, every skill invocation — settled seamlessly, no human in the loop.

🎁 $5 off every top-up during the campaign — pick any package (6 / 10 / 20 / 50 U), the discount applies automatically at aigateway wallet-topup. e.g. top up 10 U → pay 5 USDT, get 10 U.

Build agents that don't just think — but transact.

@aeon-ai-pay/aigateway is a unified CLI + Agent Skill. Through a single session-key wallet and the x402 protocol, it opens up SkillBoss's 200+ tool capabilities (image / video / audio / search / scraping / email / document / social data / UI generation, etc.) to AI Agents for pay-per-call invocation.

About SkillBoss

SkillBoss is a unified AI API + Agent Skills platform — a single API Key gives you access to models and tool capabilities from multiple providers, covering chat & reasoning, search, web scraping, image generation, video generation, audio, document processing, email, data services, and website / full-stack app deployment. Native support for Claude Code, Codex, Cursor, Windsurf, and other AI Agent tools.

Dimension	Data
Public API endpoints	359
Service providers	50
Official Skill packages	1 main + 4 sub: `skillboss` / `skillboss-image` / `skillboss-video` / `skillboss-marketing` / `skillboss-cold-email`
Skills Marketplace	500+ ready-to-use skills

Full capability surface: LLM / Chat · Embedding · Search · Scraping · Image · Video · Audio (TTS / STT) · Document · Social / Business Data · Email · Finance / Utility · Platform / Storage · Marketing / Cold Email · Full-stack App / Website Build & Deploy

SkillBoss Resources

Entry	URL
API web catalog	https://www.skillboss.co/docs/api-catalog
API JSON catalog	https://www.skillboss.co/api-catalog.json
Skills marketplace	https://www.skillboss.co/skills
Skills index API	https://www.skillboss.co/api/skills/index
Skills search API	https://www.skillboss.co/api/skills/search
Agent install entry	https://www.skillboss.co/skill.md

Architecture

┌────────────────────────────────────────────────────────────┐
│  AI Agent (Claude Code / Cursor / Codex / Windsurf / ...) │
└────────────────────┬───────────────────────────────────────┘
                     │ natural-language instructions
                     ▼
┌────────────────────────────────────────────────────────────┐
│  aigateway CLI (@aeon-ai-pay/aigateway)                    │
│   sb tools  ──→ server catalog (model + tier + schema)     │
│   sb invoke ──→ client-side inputs validation              │
│              ──→ x402 phase 1 (402 response: live price)   │
│              ──→ EIP-712 signing (session key, gasless)    │
│              ──→ auto-download image / video / audio       │
└────────────────────┬───────────────────────────────────────┘
                     │ HTTP + x402
                     ▼
┌────────────────────────────────────────────────────────────┐
│  AEON x402 Gateway (ai-api.aeon.xyz)                       │
│   dynamic pricing by model.priceUnit × usage               │
│   proxies calls to SkillBoss upstream                      │
└────────────────────┬───────────────────────────────────────┘
                     │
                     ▼
┌────────────────────────────────────────────────────────────┐
│  SkillBoss (api.skillboss.co)                              │
│   50 vendors · 359 endpoints                               │
└────────────────────────────────────────────────────────────┘

Capability Categories

Category	Pricing Unit	Description
`image`	`per_image`	Image generation / editing / upscaling / background removal
`video`	`per_second`	Video generation (requires `duration`)
`tts`	`per_1k_chars`	Text-to-speech / sound effect generation
`stt`	`per_minute`	Speech-to-text (requires `duration_minutes`)
`search`	`per_request`	Web search / map search
`scraper`	`per_request`	Web scraping / structured extraction
`social_data`	`per_request`	Social / business data
`sms`	`per_request`	SMS / OTP / email verification
`document`	`per_request`	Document parsing (PDF / DOCX → Markdown)
`ui_generation`	`per_request`	UI / prototype / slide deck generation
`financial`	`per_request`	Stock / forex / crypto / financial news
`news`	`per_request`	News APIs
`utility`	`per_request`	Domain / QR code / geo / dictionary and other utility APIs

Querying models at runtime

# Fetch the full catalog
aigateway sb tools

# Filter by category
aigateway sb tools --category image
aigateway sb tools --category video

# Filter by tier (price percentile within a category: price / balanced / quality)
aigateway sb tools --tier price
aigateway sb tools --category image --tier quality

# Look up a single model (with effectiveSchema)
aigateway sb tools --model <model_id>

Response shape: categories[].models[]. Each model carries id / vendor / useCase / price / priceUnit / tier / optional inputsOverride. Each category carries agentTrigger / defaultInputsSchema.

Prerequisites

Node.js ≥ 25
A WalletConnect-compatible mobile wallet (MetaMask / OKX Wallet / Trust Wallet, etc.)
Your main wallet holds USDT (BEP-20) plus a small amount of BNB (for the first-time approve gas, ~$0.002)

Installation

Step 1: Install the CLI (npm)

npm install -g @aeon-ai-pay/aigateway

# Verify
aigateway --version

Step 2: Install the Agent Skill (optional, for repair)

When you run npm install -g, the postinstall script already installs the skill into all detected agents. If something was missed, install it manually:

npx skills add AEON-Project/aigateway -g -y                                # install into all detected agents
npx skills add AEON-Project/aigateway -a claude-code -a cursor -a codex -g -y   # install into specific agents

Supported: Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, GitHub Copilot, Windsurf, Roo Code, 39+ more.

Step 3: Initialize the wallet

aigateway wallet-init   # generates the session key at ~/.aigateway/config.json and prints address + balance

Step 4: First-time top-up (one-time)

aigateway wallet-topup --amount 5

After scanning the WalletConnect QR code, the main wallet signs 2 transactions: transfer USDT + a small amount of BNB to the session key; the session key then broadcasts a one-time ERC20.approve(facilitator, MaxUint256). After that, sb invoke is fully gasless EIP-712 signing end-to-end.

Step 5: Invoke SkillBoss tools

aigateway sb tools --category image                                # browse available models
aigateway sb invoke --model <model_id> --inputs '{"prompt":"..."}' # invoke

Images / videos / audio are auto-downloaded into ~/aigateway-{images,videos,audio}/.

CLI Command Reference

Every command accepts --app-id <id> (merchant ID, defaults to TEST000001) and emits a single JSON envelope line to stdout: { ok, command, version, data | error }.

Command	Description	Key flags
`wallet-init`	Check / create the local session wallet (purely local — no QR, no on-chain action)	`--app-id <id>`
`wallet-topup`	WalletConnect USDT top-up (≥5 USDT, presets 5/10/20/50) + first-time approve	`--amount <usdt>`, `--private-key <key>`
`sb invoke`	The only x402 paid invocation entry point — invoke any SkillBoss model	`--model <id>` (required), `--inputs <json>` (required), `--output <dir>`, `--raw`, `--topup-amount <usdt>`
`sb tools`	Fetch the model catalog from the server in real time (no cache)	`--model <id>` / `--category <key>` / `--tier <price\|quality\|balanced>`
`wallet-balance`	Show the session wallet's USDT + BNB balance	`--private-key <key>`
`wallet-gas`	Transfer BNB from the main wallet to the session key via WalletConnect	`--amount <bnb>` (default `0.001`)
`wallet-withdraw`	Withdraw a single asset (USDT or BNB) from the session key back to the main wallet. The campaign reward portion is non-withdrawable. No args → interactive prompt.	`--amount <n>` + `--token <USDT\|BNB>` (required together for non-TTY), `--to <address>`
`clean`	Uninstall the skill + global package and clear caches	—

Global flags: --legacy-output (legacy JSON shape), --verbose, --quiet.

Usage-based pricing constraints (enforced by sb invoke client-side preflight):

video / music: must include duration (billed per second)
stt: must include duration_minutes (billed per minute)

Wallet & Pricing Model

Session key: a locally generated private key (~/.aigateway/config.json, mode 0o600). All paid calls are signed by this key, and the private key never leaves your machine.
Main wallet: your existing MetaMask / OKX / Trust wallet — only connected via the WalletConnect QR code, the main wallet's private key never touches the CLI.
First-call balance threshold: wallet balance must be ≥ 1 USDT before invocation (LOW_BALANCE_THRESHOLD).
Minimum top-up per session: ≥ 6 USDT (MIN_TOPUP_USDT), presets 6 / 10 / 20 / 50.
One-time approve: wallet-topup broadcasts a single ERC20.approve(facilitator, MaxUint256) (consumes ~0.0003 BNB); all subsequent paid calls reuse the allowance — no further on-chain tx needed.
Gasless payments: sb invoke is purely EIP-712 signing end-to-end; the server pays the gas for the on-chain USDT transfer.
Dynamic pricing: the server computes priceUnit × inputs usage in real time:
- Image: per_image × num_outputs
- Video / music: per_second × duration × num_outputs
- TTS: per_1k_chars × len(text)/1000
- Transcription: per_minute × duration_minutes
- Embedding: per_million_tokens × len(input)/4/1M
- Others: per_request × 1

Developer Integration

Reference

docs/output-schema.md — Full envelope schema for every command
docs/exit-codes.md — Exit code categories + error.code index
docs/env-vars.md — AIGATEWAY_SERVICE_URL / EVM_PRIVATE_KEY / config fallback rules
docs/troubleshooting.md — Common issues

Recipes

docs/recipes/integrate-in-agent.md — Node.js / Python subprocess wrapping
docs/recipes/merchant-integration.md — Merchant onboarding (self-custody vs. managed wallet)
docs/recipes/error-recovery.md — Recovery strategies by error code

Agent / IDE integration

docs/ide-setup.md — Manual install templates for various IDEs

Release

docs/release-process.md — Version sync, release, auto-upgrade
CHANGELOG.md — Release history

Minimal Node.js example

import { spawn } from "node:child_process";

const child = spawn("aigateway", [
  "--quiet",
  "sb", "invoke",
  "--model", "<model_id>",
  "--inputs", JSON.stringify({ prompt: "a cyberpunk fox" }),
  "--app-id", "MY_AGENT_001",
]);
let stdout = "";
child.stdout.on("data", (b) => { stdout += b; });
child.on("close", () => {
  const env = JSON.parse(stdout.trim().split("\n").pop());
  if (env.ok) {
    console.log("Image saved:", env.data.downloaded[0].localPath);
    console.log("Tx:", env.data.transaction);
  } else {
    console.error(`[${env.error.code}] ${env.error.message}`);
  }
});

Configuration

Config lives at ~/.aigateway/config.json (file mode 600). The CLI ships with a default service URL (https://ai-api.aeon.xyz); for testing or a custom backend, override via environment variables:

AIGATEWAY_SERVICE_URL — base URL of the x402 service
EVM_PRIVATE_KEY — override the saved session key (development use)

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 36 Commits
.claude		.claude
bin		bin
docs		docs
scripts		scripts
skills/aigateway		skills/aigateway
src		src
templates		templates
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

AEON AI Gateway

🚀 AEON x BNB Chain: AI Agent Campaign

About SkillBoss

SkillBoss Resources

Architecture

Capability Categories

Querying models at runtime

Prerequisites

Installation

Step 1: Install the CLI (npm)

Step 2: Install the Agent Skill (optional, for repair)

Step 3: Initialize the wallet

Step 4: First-time top-up (one-time)

Step 5: Invoke SkillBoss tools

CLI Command Reference

Wallet & Pricing Model

Developer Integration

Minimal Node.js example

Configuration

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

AEON AI Gateway

🚀 AEON x BNB Chain: AI Agent Campaign

About SkillBoss

SkillBoss Resources

Architecture

Capability Categories

Querying models at runtime

Prerequisites

Installation

Step 1: Install the CLI (npm)

Step 2: Install the Agent Skill (optional, for repair)

Step 3: Initialize the wallet

Step 4: First-time top-up (one-time)

Step 5: Invoke SkillBoss tools

CLI Command Reference

Wallet & Pricing Model

Developer Integration

Minimal Node.js example

Configuration

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages