What interwebs.ai is — and how to use it

1. Sign up and add funds. Create an account, then top up by card on the Overview tab (Stripe Checkout — unused balance is refundable any time). You only ever spend as requests bill.
2. Mint an API key. Dashboard → API → Create key. It is shown once; keys are scoped and revocable in one click.
3. Point your existing OpenAI SDK at the gateway. Change the base URL, nothing else:

from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.interwebs.ai/api/v1",
    api_key="iwk_live_…",          # minted in your dashboard
)

r = client.chat.completions.create(
    model="auto",                   # cheapest live model that clears standard quality
    messages=[{"role": "user", "content": "Summarise this contract…"}],
)
print(r.choices[0].message.content)
print(r.model_extra["interwebs"])   # the receipt: raw cost, your +5%, routing trail

The model string is the whole interface: auto (cheapest live model at standard quality), auto:economy / auto:standard / auto:premium (set the quality bar), any exact model id from the spot board (e.g. claude-sonnet-4-6), or one of your own custom routers:

curl https://gateway.interwebs.ai/api/v1/chat/completions \
  -H "Authorization: Bearer iwk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"model":"router:support-agent",
       "messages":[{"role":"user","content":"I was double-charged…"}]}'

A router is your own model id. Instead of hard-coding which model handles what, you describe your request types in plain English and each call routes itself:

1. Dashboard → API → New router. Name it — the slug becomes your model id, e.g. router:support-agent.
2. Add categories: a name (“Coding”), a when-to-use description (“programming, debugging, code review”), and a target — a pinned model, or a price tier that re-routes to the cheapest live model on every single call.
3. Set the “everything else” fallback, optionally a system prompt and sticky routing (one model per conversation — best for coding agents), and save.
4. Call it with model:"router:<slug>". One cheap classification call (≈$0.0001, itemized on your receipt) picks the category; the target model answers.

Your app or agent can create accounts for its users machine-to-machine — no browser, one call. Pass your referral code and the new account is attributed to you permanently: you earn 2% of everything it ever spends (and 1% from anyone it refers), carved out of our 5% fee. The response mints the account's first API key; its owner funds the wallet and can claim the dashboard with the same email and password any time.

curl https://gateway.interwebs.ai/api/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"new-user@example.com",
       "password":"…",
       "ref":"YOURCODE",
       "key_name":"made-by-your-tool"}'

# → 201 {
#     "user_id": "…",
#     "referred": true,
#     "api_key": { "token": "iwk_live_…" }   # shown once — hand it to your user
#   }

Attribution is first-touch and set only on brand-new accounts — an existing account can never be re-attributed, so nothing downstream of you can hijack your referrals. Invalid codes never block a signup; they just don't attribute. Signups are rate-limited per IP, and there are no per-head bounties: commission accrues only on real spend.