▸ surp.ivc.lol usage

Spend less on every AI call.

Surp uses live SurplusIntelligence.ai market prices, picks a model for the route you choose, and reuses identical answers for $0.001. Connect once and pay in USDC on Base.

Try it free Connect your agent →
204 models one OpenAI-compatible endpoint
$0.001 The system remembers answers to identical questions. You pay a fraction of a penny to reuse an old answer. You do not pay full price to make it again. exact-response cache hit
No subscription pay only for requests you make

Give Surp a route.

No wallet. No account. No API key. Start on Free. See which live model Surp would pick, then copy a prompt into your agent.

Read-only sample of what a request looks like — the route picker below picks the live model and price for this call.

Choose a route

Free = $0, daily cap · Value = smart + cheap · Frontier = best quality · Fast = lowest latency · Vision = images · Custom = tune weights

Set how much intelligence, speed, and discount matter. Cost here is Surplus % off the AA list price.

Surp routes this to
surp/free
Live model pick
loading…

Free route. Treasury pays Surplus. You pay $0 within the daily cap.

Create a free key

Start with a free Surp key, then copy the ready-to-use prompt into your agent.

Copy this into your agent

Use the key above with Surp's [OI]-compatible API. This is not a SurplusIntelligence.ai key.

Use Surp as my [OI]-compatible provider.

Base URL: https://surp.ivc.lol/v1
API key: YOUR_SURP_KEY
Model: surp/free

Do not use https://api.surplusintelligence.ai/min30/v1/chat/completions
Do not expect a SurplusIntelligence balance here. This key only works on this base URL.
Open account →

From zero to first paid call.

Pick the path that matches how your agent already works. Funding details stay closed until you need them.

1 · Choose

Pick a route: surp/free, surp/value, surp/frontier, surp/fast, surp/vision, or surp/custom.

2 · Fund

Add USDC on Base to a wallet, or use a Surp API key. Pay in USDC on Base — this page does not sell crypto.

3 · Call

Send an OpenAI-compatible request to https://surp.ivc.lol/v1.

You sign. We never hold keys. Payments are EIP-3009 authorizations in USDC on Base — Surp can settle a request but cannot move funds on its own.
Base URL check. Your Surp key only works on https://surp.ivc.lol/v1 — never on https://api.surplusintelligence.ai/min30/v1/chat/completions. Same marketplace, different router, different key. Your Surplus balance does not show here.
Connect Hermes
Install the plugin with hermes plugins install ivcained/surp-hermes-x402-llm, enable it, then use the free discovery and quote tools. Set the base URL to https://surp.ivc.lol/v1. Open the Hermes connection guide →
Pay from a wallet
Use USDC on Base. Surp returns an x402 payment challenge with the exact amount before the request is retried. Your wallet signs an EIP-3009 authorization; Surp never needs your private key. See the wallet flow →
Use an API key
Create a Surp key on this site. It is tied to this router, not to SurplusIntelligence.ai. Put the key in your agent secret store and call https://surp.ivc.lol/v1/chat/completions. Open account and funding →
Technical details belong in the docs.

Read about x402 settlement, cache fingerprints, route pools, benchmarks, model catalogs, and the gateway design when you need them. Intelligence scores: Artificial Analysis.

Read the documentation →
pricingAPI docsmodelsaboutcontactprivacysystem statusbuild a routesystem design