Modes

Every short code is locked to one mode at creation. Pick the one that fits how you work.

§01

Your key mode

mode/your-key

You supply the upstream API key. reAPI charges a flat monthly subscription for proxy access — it never touches your upstream billing. You manage key rotation and provider billing yourself. Works with any OpenAI- or Anthropic-compatible provider.

Good for: developers who already have a provider account and want predictable flat-rate proxy costs.

§02

Hosted mode

mode/hosted

reAPI manages the upstream keys. You top up a wallet and spend per token. No provider account needed — reAPI handles authentication with the upstream on your behalf. Mappings are pre-configured at code creation so your first request works immediately.

Good for: Office users who want a single setup step and no provider account to manage.

§03

Mode is locked at creation

Once a short code is created, its mode can't be changed. If you want to try both, create a separate code for each. The two codes are independent — different base URLs, different billing, different mappings.

Common questions

Which mode should I pick?

If you already have an account with an OpenAI- or Anthropic-compatible provider and want to keep using your own key, pick Your key mode. If you want the simplest possible setup — no provider account, no key management — pick Hosted mode.

Can I switch modes later?

No. Mode is locked for the lifetime of the short code. Create a new code if you want the other mode.

What providers work with Your key mode?

Any provider that speaks an OpenAI- or Anthropic-compatible API. You configure the provider's base URL and protocol in each mapping row.