IP allowlists, sub-accounts and permission tiers: a survey of relay governance

Tutorials Published 2026-10-06 77 views API Compass
Governance decides whether a site is usable for teams and commercial work. This article gives a checklist you can score item by item.

Why "does it work" is not enough

Personal use needs three conditions: it connects, the price is acceptable, it is stable enough.

The moment a team or commercial use is involved, a different set of capabilities matters: who may use it, how much they used, and how to investigate when something goes wrong. That set is what we mean by "governance".

Governance cannot be established by one test call. It is a question of which features exist. So what follows is a tick-box checklist you can take and compare directly.

Dimension one: credential governance

#CheckpointImportance
1Can create multiple keysRequired
2Each key can carry a spending capRequired
3Each key can carry a model allowlistImportant
4Each key can carry an IP allowlistImportant
5Each key can carry an expiry dateNice to have
6Keys can be temporarily disabled rather than deletedImportant

Item 6 is easily overlooked and very practical: disabling keeps the logs and is reversible, while deletion destroys the audit trail. During an incident — see our article on emergency response to a key leak — whether you can "disable first, then investigate" directly determines how fast you can respond.

Item 2 is a required one: it is the only mechanism that stops the bleeding automatically. If the site does not support it, you have to implement counting and blocking in your own code.

Dimension two: organisational governance

#CheckpointImportance
7Supports sub-accounts with independent loginsRequired for teams
8Independent quotas between sub-accountsRequired for teams
9Supports role separation (admin, read-only, standard)Needed for commercial use
10Supports quotas split by project or groupNeeded for commercial use

Sub-accounts versus multiple keys: multiple keys are just multiple credentials, while sub-accounts mean independent login and permissions. The former suits "the same people using different purposes", the latter suits "different people each using their own".

If there are no sub-accounts: fall back to multiple keys plus a naming convention (key-alice-prod) and your own record of who uses which key. That gets you basic control, minus the self-service queries and independent logins.

Dimension three: observability

#CheckpointImportance
11Provides call logs with time, model and token countsRequired
12Logs can be filtered by keyRequired
13Logs retained for at least 30 daysImportant
14Can view balance and consumption trendsRequired
15Supports balance alerts by email, SMS or webhookImportant
16Has an API for querying usage, so you can aggregate it yourselfNice to have

Items 11 and 12 are required: without logs you have neither reconciliation nor incident investigation.

Item 16 is worth a lot. With it you can pull usage into your own reporting and build a single view across suppliers. If a site only offers a web dashboard, you are reduced to manual screenshots.

Dimension four: billing and settlement

#CheckpointImportance
17Billing basis is stated in writing, including multiplier baseline and input/output parityRequired
18Supports bank transfer and invoicingRequired for enterprises
19Provides an exportable billNeeded for enterprises
20Balance is refundable, with clear conditionsImportant

Item 17 matters in personal use too, since without the basis you cannot reconcile. See our article on the five terms to check before topping up.

Dimension five: technical and availability

#CheckpointImportance
21Has a status page or announcement channelNice to have
22Provides an incident response commitmentNeeded for commercial use
23Supports multi-channel redundancy, so one channel failing can be routed aroundImportant
24Has a technical support contact with timely responsesImportant

How to use this checklist

Layer it by purpose:

  • Personal use: only items 1, 2, 11 and 14 matter.
  • Small team, 3 to 10 people: 1 to 6, 7, 8, 11, 12, 14, 15, 17, 20.
  • Commercial or enterprise: all of them, with 9, 10, 16, 18, 19 and 22 as additional thresholds.

Scoring: record each item as present, absent or partial for 1, 0 or 0.5, and weight by importance from the tables. A site below 60% is not suitable as a team's primary supplier.

Workarounds for missing features

Most relay sites are incomplete on governance. Missing features do not make a site unusable, because you can cover them yourself:

Missing capabilityHow to cover it
No sub-accountsMultiple keys plus a naming convention and a registry of who uses which
No spending capsCounting and blocking at the application layer, with all requests through one exit point
No logsRecord model and usage per call on your own server
No balance alertsPull usage daily and fire your own notification past a threshold
No usage APIExport periodically by hand, or use the dashboard's export function
No IP allowlistAt least keep a fixed egress IP so problems can be located
No invoicingMove to a site that invoices, or split usage across suppliers who can

"Record call logs on your own server" is worth doing unconditionally. It depends on nothing from the site, and the moment you need to aggregate across suppliers, or explain usage to a colleague, it is the only evidence you have.

One criterion to close on

A simple test: if the site's dashboard cannot show usage split by key, it is only usable for personal use.

Because that means any team-scale use immediately degrades into "an unreadable pile of usage", and every subsequent control, optimisation and accountability step becomes impossible.

Was this useful? If you have run into something the article does not cover, tell us and we will verify it and update the text.

Related articles

Video generation behind a relay: three API shapes, four billing traps, one acceptance checklist

2026-10-19

MCP through a relay: what works, what never will, and how to test it in ten minutes

2026-10-19

A relay selection decision tree: working back from your scenario to a site

2026-10-07

Logging and reconciliation: attributing token spend to the project level

2026-10-06

Migrating suppliers gradually: replacing an API site without interrupting service

2026-10-06

Build your own probe: twenty lines of script to monitor your API suppliers

2026-10-06

Read on: a few of the services we list

This article does not point at a specific model family, so here are a few of the highest-scoring services we list, in case you want to read on. They are ordered by score and uptime and are not a recommendation.

See the full list in the directory, or browse by model family.