cita-777/metapi

What is it?

Key features

• 01Exposes OpenAI and Claude compatible endpoints, including chat, responses, embeddings and files.
• 02Discovers models from upstream sites automatically and builds the routing table without manual setup.
• 03Routes requests by weighted cost, balance and usage, with automatic failover and cooldown.
• 04Schedules daily check-ins and periodic balance refreshes for each account.
• 05Sends alerts through Webhook, Bark, Server酱, Telegram or SMTP email.
• 06Deploys as a single Docker container with SQLite, MySQL or PostgreSQL storage.

Use cases

• Consolidating API keys from several relay sites so editors and chat tools use one endpoint.
• Routing requests to the cheapest available channel for a given model.
• Tracking balances and check-in rewards across many relay accounts in one dashboard.
• Keeping AI tools working through upstream outages by failing over to other channels.

Quick start

1. 1

   Create a project folder

   mkdir metapi && cd metapi
2. 2

   Create the docker-compose.yml file with the README configuration

3. 3

   Set the admin token and proxy token, then start the container

   export AUTH_TOKEN=your-admin-token && export PROXY_TOKEN=your-proxy-sk-token && docker compose up -d
4. 4

   Open http://localhost:4000 and log in with AUTH_TOKEN

Things to know

• !The README warns that the default admin token change-me-admin-token applies when running outside Compose without AUTH_TOKEN set, so credentials must be changed before use.
• !Armv7l support covers only server and Docker deployment, with no desktop installer.

In collections

Topics

FAQ

What is metapi?

A self-hosted gateway that merges multiple AI relay sites (New API, One API, Sub2API and others) into one API key and endpoint with smart routing. Metapi aggregates several AI relay sites built on New API, One API, OneHub, DoneHub, Veloera, AnyRouter, Sub2API and similar panels, along with some OpenAI, Claude and Gemini compatible endpoints and OAuth-connected accounts. Downstream tools such as Cursor, Claude Code, Codex or Open WebUI connect to a single proxy endpoint and can call every discovered model through it, with models from upstream sites appearing automatically.

Is metapi free to use? What license does it have?

metapi is open source under the MIT license. Check the license terms before using it in commercial products.

Is metapi still maintained?

Updated within 6 months. The last commit to metapi was on Sep 6, 2026.

What can I use metapi for?

Consolidating API keys from several relay sites so editors and chat tools use one endpoint. Routing requests to the cheapest available channel for a given model. Tracking balances and check-in rewards across many relay accounts in one dashboard. Keeping AI tools working through upstream outages by failing over to other channels.

How do I install metapi?

Create a project folder: mkdir metapi && cd metapi Create the docker-compose.yml file with the README configuration Set the admin token and proxy token, then start the container: export AUTH_TOKEN=your-admin-token && export PROXY_TOKEN=your-proxy-sk-token && docker compose up -d Open http://localhost:4000 and log in with AUTH_TOKEN

Where can I get metapi?

The source code and installation instructions are on GitHub: https://github.com/cita-777/metapi