Does New API (self-hosted) have a free tier?
The software is free and open source; the real cost is the usage on whatever upstream keys you plug in, plus the box it runs on.
New API (self-hosted): get an API key and write fiction with it on your phone
An open-source, self-hosted gateway (software, not a vendor): pool your own provider keys behind one console you control, with unified routing, quota enforcement, and usage accounting — the phone talks only to your gateway, and upstreams swap freely. This page is the BYOK quick answer for New API (self-hosted): key steps, direct console and pricing links, and the app-side notes that matter. Verified 2026-07-18.
Two links up front: get your key at the official download page (it runs locally — there is no pricing page because there is no bill). Prices and free quotas move; the official pages are authoritative.
What does it power inside Foreverse?
The factory preset declares 1 modality flag for New API (self-hosted). The models actually available come from the live catalog fetched in-app — catalogs move fast, and the flag only means the protocol wiring is ready.
| Modality | Used for |
|---|---|
| Text | Continuation · roleplay chat · agent |
How do I install New API (self-hosted) and reach it from my phone?
- Start the server with Docker on a computer or NAS: docker run -d -p 3000:3000 -v ./data:/data calciumion/new-api:latest (Docker Compose with PG/Redis for production).
- Open http://<host-IP>:3000 in a browser and set the admin account via the first-run wizard.
- Add upstreams on the Channels page (real vendor keys + base URLs), then create a downstream token on the Tokens page — an sk- key that can carry quota, expiry, and a model allowlist.
- With your phone on the same Wi-Fi (or Tailscale), point the New API host in the app to http://<host-IP>:3000/v1 and paste the token as the key.
Key in hand: three steps to connect
- Open the app's Settings → AI models & services and find New API (self-hosted) in the list (one of 62 presets, with logo and search).
- Paste the key and tap the connectivity test — it fires one real request to verify key and network, and pulls back the model list while it's at it.
- Enable the models you want, then set per-modality defaults (text, image, speech, and video each get their own); continuation, chat, and listening route through them from then on.
The one universal host pitfall: the API host must include its full version prefix (this provider's exact form is in the notes below) — the app never appends /v1 for you.
New API (self-hosted)-specific notes
The preset host is http://localhost:3000/v1 — on a real phone, replace localhost with the host machine's LAN or Tailscale IP; behind a reverse-proxied domain the /v1 suffix still applies. Issuing the phone its own quota-capped, model-allowlisted token is the safer setup. The sibling project one-api wires up identically.
FAQ
Where does the key live once I paste it into the app?
It's stored on your device only, under system-level encryption — never uploaded or synced to any Foreverse server. Requests go straight from your phone to the provider's official endpoint with zero markup. To revoke access, delete the key in the provider's console.