Repolode
Enviar
cita-777

cita-777/metapi

Um gateway auto-hospedado que reúne vários serviços de relay de IA (New API, One API, Sub2API e outros) em uma única chave de API e endpoint, com roteamento inteligente.

Ver no GitHubSite
Estrelas
3,334
Forks
527
Issues abertas
112
Último commit
há 2 meses

O que é?

O Metapi agrega vários serviços de relay de IA baseados em painéis como New API, One API, OneHub, DoneHub, Veloera, AnyRouter, Sub2API e similares, além de alguns endpoints compatíveis com OpenAI, Claude e Gemini e contas conectadas via OAuth. Ferramentas como Cursor, Claude Code, Codex e Open WebUI se conectam a um único endpoint de proxy e podem chamar por ele todos os modelos encontrados, que aparecem automaticamente conforme são descobertos nos serviços upstream.

As solicitações são distribuídas entre os canais por probabilidade ponderada, considerando custo, saldo e taxa de uso. Canais com falha entram em período de espera, e as solicitações são tentadas novamente em outros canais disponíveis. O painel acompanha os saldos nos serviços, executa check-ins agendados, atualiza os saldos de hora em hora por padrão e envia alertas via Webhook, Bark, Server酱, Telegram ou SMTP.

O Metapi é distribuído em um único contêiner Docker, usando SQLite por padrão, e também pode usar MySQL ou PostgreSQL como banco de dados em tempo de execução. É desenvolvido com Fastify, React e TypeScript, e licenciado sob a MIT.

Recursos principais

  • 01Disponibiliza endpoints compatíveis com OpenAI e Claude, incluindo chat, responses, embeddings e arquivos.
  • 02Descobre automaticamente os modelos nos serviços upstream e monta a tabela de roteamento sem configuração manual.
  • 03Roteia solicitações considerando custo, saldo e uso ponderados, com failover automático e período de espera.
  • 04Agenda check-ins diários e atualizações periódicas de saldo para cada conta.
  • 05Envia alertas via Webhook, Bark, Server酱, Telegram ou e-mail SMTP.
  • 06É implantado em um único contêiner Docker, com armazenamento em SQLite, MySQL ou PostgreSQL.

Casos de uso

  • Consolidar chaves de API de vários serviços de relay para que editores e ferramentas de chat usem um único endpoint.
  • Direcionar solicitações para o canal disponível mais barato para determinado modelo.
  • Acompanhar saldos e recompensas de check-in de várias contas de relay em um único painel.
  • Manter as ferramentas de IA funcionando durante interrupções nos serviços upstream, redirecionando as solicitações para outros canais.

Início rápido

  1. 1

    Crie uma pasta para o projeto

    mkdir metapi && cd metapi
  2. 2

    Crie o arquivo docker-compose.yml com a configuração do README

  3. 3

    Defina o token de administrador e o token do proxy e, em seguida, inicie o contêiner

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

    Acesse http://localhost:4000 e faça login com AUTH_TOKEN

Antes de usar

  • O README alerta que, ao executar fora do Compose sem definir AUTH_TOKEN, o token de administrador padrão change-me-admin-token é aplicado. Portanto, as credenciais devem ser alteradas antes do uso.
  • O suporte a Armv7l abrange apenas o servidor e a implantação com Docker; não há instalador para desktop.

Em coleções

Apps auto-hospedadosFrameworks de microsserviços e infraestrutura de serviços

Tópicos

#llm-gateway#api-gateway#openai-compatible#load-balancing#model-routing#self-hosted#docker

Perguntas frequentes

O que é metapi?
Um gateway auto-hospedado que reúne vários serviços de relay de IA (New API, One API, Sub2API e outros) em uma única chave de API e endpoint, com roteamento inteligente. O Metapi agrega vários serviços de relay de IA baseados em painéis como New API, One API, OneHub, DoneHub, Veloera, AnyRouter, Sub2API e similares, além de alguns endpoints compatíveis com OpenAI, Claude e Gemini e contas conectadas via OAuth. Ferramentas como Cursor, Claude Code, Codex e Open WebUI se conectam a um único endpoint de proxy e podem chamar por ele todos os modelos encontrados, que aparecem automaticamente conforme são descobertos nos serviços upstream.
metapi é gratuito? Qual é a licença?
metapi é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
metapi ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de metapi foi em 6 de set. de 2026.
Para que posso usar metapi?
Consolidar chaves de API de vários serviços de relay para que editores e ferramentas de chat usem um único endpoint. Direcionar solicitações para o canal disponível mais barato para determinado modelo. Acompanhar saldos e recompensas de check-in de várias contas de relay em um único painel. Manter as ferramentas de IA funcionando durante interrupções nos serviços upstream, redirecionando as solicitações para outros canais.
Como instalar metapi?
Crie uma pasta para o projeto: mkdir metapi && cd metapi Crie o arquivo docker-compose.yml com a configuração do README Defina o token de administrador e o token do proxy e, em seguida, inicie o contêiner: export AUTH_TOKEN=your-admin-token && export PROXY_TOKEN=your-proxy-sk-token && docker compose up -d Acesse http://localhost:4000 e faça login com AUTH_TOKEN
Onde consigo metapi?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/cita-777/metapi

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados