ForgeGrit

What this is

ForgeGrit serves only full-capability frontier models. No 1B toys, no distilled "lite" tiers, no trial credits that expire into a bill. You register, you get a key, you get 100,000 requests a day. That's the whole product.

The API speaks the OpenAI format, so anything already pointed at /v1/chat/completions works by changing two lines.

Get a key

Playground

Chat

Image

Chats sent here are logged with your account.

Model

System prompt — optional

Message

Send Clear

Queued, one at a time. Images come from Pollinations.ai on their anonymous tier, so each one waits its turn and may carry a watermark. There is no daily limit.

Model

Size 1024 × 1024 (square) 1024 × 768 (landscape) 768 × 1024 (portrait)

Prompt

Generate Clear

Project Frominsidge

copy# check your access
curl https://api-forgegrit.serveousercontent.com/v1/frominsidge/status \
  -H "Authorization: Bearer YOUR_KEY"

# once active
curl https://api-forgegrit.serveousercontent.com/v1/frominsidge/models \
  -H "Authorization: Bearer YOUR_KEY"

Project Gamer

Describe a game and get a small 3D world you can explore for 60 seconds. Anyone can use it, no key needed. Each address waits 20 seconds between games.

Mail, storage, and Agent keys

These are for members of Project Frominsidge. Log in above first.

Project Comet

Comet is for members of Project Frominsidge. Anyone else who tries it is told to enroll in Project Frominsidge first.

Beta program

The beta is for members of Project Frominsidge. If you’re approved there, you’re in the beta, with no separate sign-up.

Check your own limit and credits with GET /v1/usage. Frominsidge status, including beta, is at GET /v1/frominsidge/status.

Quickstart

Base URL:

copyhttps://api-forgegrit.serveousercontent.com

copycurl -X POST https://api-forgegrit.serveousercontent.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "messages": [{"role": "user", "content": "Say hello"}]
  }'

copyimport requests

r = requests.post(
    "https://api-forgegrit.serveousercontent.com/v1/chat/completions",
    headers={"Authorization": "Bearer YOUR_KEY"},
    json={
        "model": "claude-opus-5",
        "messages": [{"role": "user", "content": "Say hello"}],
    },
    timeout=300,
)
print(r.json()["choices"][0]["message"]["content"])

copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api-forgegrit.serveousercontent.com/v1",
    api_key="YOUR_KEY",
)

r = client.chat.completions.create(
    model="claude-opus-5",
    messages=[{"role": "user", "content": "Say hello"}],
)
print(r.choices[0].message.content)

copyconst res = await fetch(
  "https://api-forgegrit.serveousercontent.com/v1/chat/completions", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "claude-opus-5",
    messages: [{ role: "user", content: "Say hello" }]
  })
});
const data = await res.json();
console.log(data.choices[0].message.content);

Command line

Chat with every ForgeGrit model from your terminal. Works anywhere Python 3.8+ runs, including Termux.

copypip install forgegrit-cli

Sign in — pick one:

copyforgegrit login              # your ForgeGrit email + password (2FA supported)
forgegrit register           # create a new ForgeGrit account
forgegrit api YOUR_KEY       # use an API key you already have

Then use it:

copyforgegrit chat                       # interactive chat, replies stream in
forgegrit chat -m claude-sonnet-5-5  # pick a model
forgegrit chat -r                    # resume your latest conversation
forgegrit sessions                   # list saved conversations
forgegrit frominsidge                # Project Frominsidge status / enroll
forgegrit ask "explain recursion"    # one-shot question
cat notes.txt | forgegrit ask        # pipe text in
forgegrit models                     # list models
forgegrit model claude-opus-5        # set your default model
forgegrit usage                      # requests used today
forgegrit whoami                     # show the saved login
forgegrit logout                     # forget the saved key

The model can run commands. In chat it can run shell commands on your machine, as you, in the folder you started from — you approve each one (y / n / a for the rest of the session). sudo, su and doas are always refused. Use --no-commands or /commands off to switch it off.

Inside chat: /model ID, /system TEXT, /clear, /resume [N], /forget [N], /commands on|off, /help, /exit. Conversations are saved to ~/.forgegrit/sessions/. Your key is saved to ~/.forgegrit/config.json, readable only by you. Set FORGEGRIT_API_KEY to override it, or NO_COLOR=1 to turn off colours. Chats sent through the CLI are logged like any other request.

forgegrit-cli on PyPI →

Models

Pass any of these as model. All full-size — nothing here is a distilled variant.

Live list, filtered to what your key can reach:

copycurl https://api-forgegrit.serveousercontent.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

Flagship

ForgeGrit’s own models. Ranked by our tiering, cheapest first — and all $0 here.

Pricing

Every other model here has a published rate card. Below is what each costs on its own API, in USD per million tokens — and what the identical model costs on ForgeGrit.

What that means in practice

A month of moderate agent work — 10M input tokens and 2M output — run on the top model:

Everywhere else the money usually hides

So what's the catch

Honestly: uptime. ForgeGrit runs on self-hosted hardware behind a tunnel, paid for out of pocket. Nobody is billed because nobody is being sold anything — but that also means there is no SLA, no support contract, and no promise the endpoint answers at 3am. /health is the honest answer at any given moment.

The 100,000 daily requests exist to stop one client from starving everyone else. Hit it and you get a 429, never an invoice.

Endpoints

Register

copycurl -X POST https://api-forgegrit.serveousercontent.com/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}'

Get your key

copycurl -X POST https://api-forgegrit.serveousercontent.com/authenticate/email \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}'

Returns api_key, owner_id, and rpd_limit. Logging in again always returns the same key, so there is nothing to lose — if you misplace it, just log in.

Rotate your key

Keys do not expire. If yours ends up somewhere it shouldn't — a screenshot, a commit, a pasted log — rotate it. This revokes every existing key on the account and issues a new one. The old key stops working immediately.

copycurl -X POST https://api-forgegrit.serveousercontent.com/authenticate/rotate \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}'

Your account, usage history, and daily limit are unaffected — only the key changes.

Two-factor authentication

ForgeGrit supports time-based one-time codes (TOTP) from any authenticator app — Aegis, Google Authenticator, 1Password, whatever you already use. With it on, a stolen password is not enough to log in, and a code someone captures is dead within thirty seconds.

Enrol in two calls. The first returns a secret and an otpauth:// URI:

copycurl -X POST https://api-forgegrit.serveousercontent.com/authenticate/2fa/setup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}'

Add the secret to your authenticator, then confirm with a live code:

copycurl -X POST https://api-forgegrit.serveousercontent.com/authenticate/2fa/enable \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password","code":"123456"}'

From then on, include code when you log in, rotate, or change your password. Each code works once — reusing one returns code_reused, so wait for the next.

/authenticate/2fa/disable turns it off and takes the same password plus code.

Change your password

copycurl -X POST https://api-forgegrit.serveousercontent.com/authenticate/change-password \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"old","new_password":"new","code":"123456"}'

Your API key survives a password change. Omit code if 2FA is off.

Using ForgeGrit inside someone else’s app

Because keys are free and per-account, apps can ask each user for their own ForgeGrit key instead of shipping one. Good pattern — but get your key here and paste it in.

Streaming

Add "stream": true for server-sent events. Chunks arrive as data: lines, terminated by data: [DONE].

copycurl -N -X POST https://api-forgegrit.serveousercontent.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Count to five"}],
    "stream": true
  }'

Images

One image model, flux-image, served by Pollinations.ai on their anonymous tier. It has no daily limit. Requests are queued and run one at a time, about one every 15 seconds, so a request can wait behind others. Images may carry a watermark.

copycurl -X POST https://api-forgegrit.serveousercontent.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"flux-image","prompt":"a red fox in fresh snow","size":"1024x1024"}'

The call returns a job_id straight away. Poll it until status is done. While it waits, position is how many jobs are ahead of yours. When it is done, data[0].url holds the image.

copycurl https://api-forgegrit.serveousercontent.com/v1/images/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/queue shows how busy the image queue is. A full queue answers 503.

Health

copycurl https://api-forgegrit.serveousercontent.com/health

{"status":"ok","inference":"ok"} means inference is up. degraded means the backend is unreachable — retry shortly.

Parameters

Limits & errors

Check where you stand at any time:

copycurl https://api-forgegrit.serveousercontent.com/v1/usage \
  -H "Authorization: Bearer YOUR_KEY"

100,000 requests per day per account — the quota follows the account, not the key, so rotating does not reset it. The counter resets at midnight. There is no paid tier to upgrade to — the limit exists to stop abuse, not to sell you anything.