Anonymo speaks the OpenAI API. Any client or SDK that lets you set a base URL works: point it at Anonymo, use your key, and pick one of the four model IDs.
Send your key as a Bearer token: Authorization: Bearer anm_live_…. There is no account behind it. The gateway keeps only a hash of the key, so a lost key cannot be recovered. Create one in the workspace or with POST /keys.
The OpenAI chat completions request and response, with an Anonymo receipt added to the reply.
| Field | Type | Description |
|---|---|---|
model | string · required | One of the model IDs below. |
messages | array · required | The conversation, as role and content pairs. |
stream | boolean | Stream tokens as server-sent events. The last event carries the receipt. Not for anonymo-council. |
max_tokens | number | Upper limit on the reply length. |
temperature | number | Sampling temperature. |
council.mode | merge · select | anonymo-council only: merge the replies, or have a judge pick one (cheaper). |
Optional headers:
x-anonymo-refusal-catch: off turns off the refusal catch, which holds back the first tokens to catch a refusal and reroute it. Off streams sooner.x-anonymo-sealed: required sends the request only to hardware-attested routes, or fails with 409.anonymo-1 | The best uncensored route for each request. Refusals reroute to a different family and are refunded. |
anonymo-rp | Long-context roleplay on self-hosted models, with character cards. Not live yet. |
anonymo-council | Several model families answer and check each other; one reply comes back. Priced at 4–5×. |
anonymo-sealed | Hardware-attested enclaves only. Fails instead of downgrading. Not live yet. |
GET /v1/models lists the ones that are live right now; a model that is not live answers 404 model_not_found. The manifest shows every route behind each ID.
Every reply carries anonymo_receipt: the routes that ran, token counts, cost, and an Ed25519 signature. Receipts roll into an hourly Merkle root posted on-chain. GET /v1/receipts/:id/proof returns the inclusion proof, so you can check it yourself.
| 451 | floor_blocked | Falls under one of the four blocked lines. A blocked prompt is never sent to a model. A reply that crosses a line is withheld (metadata.stage is reply; on a stream it arrives as an error event after the text already checked). Never rerouted, never charged. |
| 503 | floor_unavailable | The safety check could not run, so nothing was served. Nothing was charged; try again shortly. |
| 409 | sealed_unavailable | No attested route is up. Nothing was sent or charged. |
| 402 | insufficient_balance | Not enough credit. Add funds and retry. |
| 429 | — | Too many requests for this key right now. |
POST /keys creates a key and returns it once, with its deposit instructions. Optional caps: daily, monthly and lifetime spend, a model allowlist, an IP allowlist, sealed only and an expiry.GET /balance shows available, held and usage-only credit.GET /deposits lists deposits. POST /withdraw sends unused stablecoin credit back to the wallet it came from, and needs an Idempotency-Key header.