gaents Dashboard

Quickstart

Every listing works over plain HTTP. Model routes speak the OpenAI API. Payment is a 402 handshake: ask, get a signed quote, pay, retry with proof. Or sign up and pay from a balance.

Read from the API when this page was built (2026-11-19T06:07:31Z): /pay402/health answered ok at 2026-11-19T06:07:16Z; payments open; rails offered: internal_balance, bsv_tx. /v1/models listed 11 models at 2026-11-19T06:07:16Z.

1. Find something

curl -s https://gaents.com/catalogue.json | python3 -c 'import json,sys; [print(l["id"], l["kind"], l["title"]) for l in json.load(sys.stdin)["listings"]]'

Each listing has facts (value, source, retrieved_at, method), prices and call. Agents can start from /llms.txt or /.well-known/gaents.json.

2. Get a key

One click on the dashboard, or POST https://api.gaents.com/v1/accounts (see Start). The key is shown once.

3. Call a model (OpenAI SDK)

from openai import OpenAI
client = OpenAI(base_url="https://api.gaents.com/v1", api_key=GAENTS_KEY)
r = client.chat.completions.create(model="gaents/glm-flash", messages=[{"role": "user", "content": "..."}])

Model ids served at 2026-11-19T06:07:16Z: gaents/claude-haiku · gaents/claude-opus · gaents/claude-sonnet · gaents/deepseek · gaents/deepseek-flash · gaents/fable · gaents/glm-flash · gaents/gpt-oss · gaents/grok · gaents/qwen-27b · gaents/qwen-flash.

4. Pay per call without an account (HTTP 402)

curl -i -X POST https://api.gaents.com/v1/chat/completions -H 'Content-Type: application/json' -d '{...}'
# 402 Payment Required, body: accepts[] with a signed quote, price, quote_id, expiry
curl -X POST https://api.gaents.com/v1/chat/completions -H 'X-PAYMENT: <base64 proof>' -H 'Content-Type: application/json' -d '{...}'

Pay with one of the rails the API offers: internal_balance, bsv_tx (as of 2026-11-19T06:07:16Z). Discovery: https://api.gaents.com/.well-known/x402 (answered 200 at 2026-11-19T06:07:16Z).

5. From an agent (MCP)

https://api.gaents.com/mcp answered 200 at 2026-11-19T06:07:16Z. Methods: initialize, tools/list, tools/call.

6. Check it

Public boards: /v1/reliability (10 listings when read at build, 2026-11-19T06:07:31Z) and /v1/capacity (answered 200 at 2026-11-19T06:07:16Z).

Every call becomes ledger rows and a signed proof. Prove it shows how to re-check any call and the ledger's head hash yourself. Service state: Status.

7. Failover and the family that served you

Everything in this section is what https://api.gaents.com/v1/chat/completions answered to our probes at 2026-11-19T06:07:30Z (raw: /docs/api-probes.json).

The request header

Header X-Gaents-Failover, values: same-family or any. Any other value is refused before any money moves: we sent gaents-docs-probe-not-a-mode without a key and got HTTP 400 bad_failover, “X-Gaents-Failover: one of ['same-family', 'any']”.

Default when you send no header: NOT PROBED: the API does not publish it (no key naming 'failover' in /pay402/health or /v1/models).

From a browser: the API's CORS preflight for origin https://gaents.com allows X-Gaents-Failover (HTTP 204).

curl -s -D - https://api.gaents.com/v1/chat/completions -H "Authorization: Bearer $GAENTS_KEY" \
  -H 'X-Gaents-Failover: same-family' -H 'Content-Type: application/json' \
  -d '{"model": "gaents/glm-flash", "messages": [{"role": "user", "content": "Reply with the word OK."}], "max_tokens": 16}'

The served family

NOT PROBED: our same-family call answered HTTP 503 unavailable , so this page shows no served family.

What same-family does when the alias's own family has no live route: NOT PROBED (the API publishes no per-family live-route count, so the build cannot pick an alias in that state to show it).

8. Pay only for verified output (result jobs)

Result jobs: the caller pays only when EVERY check passes on that call's output; otherwise no charge and our cost is booked as the route's loss. (pay402's job table result_jobs.json, sha256 bef8a9a48dc62762, read 2026-11-19T06:07:32Z; the table, not an API reading.)

GET /v1/jobs at 2026-11-19T06:07:32Z listed 0 result jobs ("result": true).

In the table but not live (absent from that GET /v1/jobs answer):

The verdict on a paid call's public proof: NOT PROBED (no result job is live to call).