Repolode
제출하기
cita-777

cita-777/metapi

여러 AI 릴레이 사이트를 하나의 API 키와 엔드포인트로 통합하고 스마트 라우팅을 제공하는 셀프 호스팅 게이트웨이입니다.

GitHub에서 보기웹사이트
스타
3,334
포크
527
열린 이슈
112
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Metapi는 New API, One API, OneHub, DoneHub, Veloera, AnyRouter, Sub2API 등의 패널로 구축된 여러 AI 릴레이 사이트와 OpenAI, Claude, Gemini 호환 엔드포인트 일부, OAuth로 연결된 계정을 통합합니다. Cursor, Claude Code, Codex, Open WebUI 같은 다운스트림 도구는 단일 프록시 엔드포인트에 연결해 검색된 모든 모델을 호출할 수 있으며, 업스트림 사이트의 모델도 자동으로 표시됩니다.

요청은 비용, 잔액, 사용률을 기준으로 가중 확률을 적용해 여러 채널에 분산됩니다. 실패한 채널은 일정 시간 쿨다운 상태가 되고, 요청은 사용 가능한 다른 채널로 재시도됩니다. 대시보드에서는 사이트별 잔액을 추적하고, 예약된 체크인을 실행하며, 기본적으로 매시간 잔액을 갱신하고, Webhook, Bark, Server酱, Telegram 또는 SMTP를 통해 알림을 보냅니다.

Metapi는 기본적으로 SQLite를 사용하는 단일 Docker 컨테이너로 제공되며, 런타임 데이터베이스로 MySQL 또는 PostgreSQL을 사용할 수도 있습니다. Fastify, React, TypeScript로 구축되었으며 MIT 라이선스를 따릅니다.

핵심 기능

  • 01chat, responses, embeddings, files를 포함한 OpenAI 및 Claude 호환 엔드포인트를 제공합니다.
  • 02업스트림 사이트의 모델을 자동으로 검색하고, 수동 설정 없이 라우팅 테이블을 구성합니다.
  • 03비용, 잔액, 사용량을 기준으로 요청을 라우팅하며 자동 장애 조치와 쿨다운을 지원합니다.
  • 04각 계정의 일일 체크인과 주기적인 잔액 갱신을 예약합니다.
  • 05Webhook, Bark, Server酱, Telegram 또는 SMTP 이메일로 알림을 보냅니다.
  • 06SQLite, MySQL 또는 PostgreSQL을 저장소로 사용하는 단일 Docker 컨테이너로 배포할 수 있습니다.

활용 사례

  • 여러 릴레이 사이트의 API 키를 통합해 편집기와 채팅 도구가 하나의 엔드포인트를 사용하도록 합니다.
  • 모델별로 사용 가능한 채널 중 가장 저렴한 곳에 요청을 라우팅합니다.
  • 하나의 대시보드에서 여러 릴레이 계정의 잔액과 체크인 보상을 추적합니다.
  • 업스트림 장애가 발생해도 다른 채널로 장애 조치해 AI 도구를 계속 사용할 수 있도록 합니다.

빠른 시작

  1. 1

    프로젝트 폴더를 만듭니다

    mkdir metapi && cd metapi
  2. 2

    README 설정을 사용해 docker-compose.yml 파일을 만듭니다

  3. 3

    관리자 토큰과 프록시 토큰을 설정한 다음 컨테이너를 시작합니다

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

    http://localhost:4000을 열고 AUTH_TOKEN으로 로그인합니다

사용 전 알아둘 점

  • README에 따르면 Compose를 사용하지 않고 AUTH_TOKEN을 설정하지 않은 상태로 실행하면 기본 관리자 토큰인 change-me-admin-token이 적용됩니다. 사용 전에 자격 증명을 변경해야 합니다.
  • Armv7l 지원은 서버 및 Docker 배포에만 해당하며 데스크톱 설치 프로그램은 제공되지 않습니다.

포함된 컬렉션

셀프 호스팅 앱마이크로서비스 프레임워크와 서비스 인프라

토픽

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

자주 묻는 질문

metapi은(는) 무엇인가요?
여러 AI 릴레이 사이트를 하나의 API 키와 엔드포인트로 통합하고 스마트 라우팅을 제공하는 셀프 호스팅 게이트웨이입니다. Metapi는 New API, One API, OneHub, DoneHub, Veloera, AnyRouter, Sub2API 등의 패널로 구축된 여러 AI 릴레이 사이트와 OpenAI, Claude, Gemini 호환 엔드포인트 일부, OAuth로 연결된 계정을 통합합니다. Cursor, Claude Code, Codex, Open WebUI 같은 다운스트림 도구는 단일 프록시 엔드포인트에 연결해 검색된 모든 모델을 호출할 수 있으며, 업스트림 사이트의 모델도 자동으로 표시됩니다.
metapi은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
metapi은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
metapi은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. metapi의 마지막 커밋은 2026년 9월 6일입니다.
metapi은(는) 어디에 사용할 수 있나요?
여러 릴레이 사이트의 API 키를 통합해 편집기와 채팅 도구가 하나의 엔드포인트를 사용하도록 합니다. 모델별로 사용 가능한 채널 중 가장 저렴한 곳에 요청을 라우팅합니다. 하나의 대시보드에서 여러 릴레이 계정의 잔액과 체크인 보상을 추적합니다. 업스트림 장애가 발생해도 다른 채널로 장애 조치해 AI 도구를 계속 사용할 수 있도록 합니다.
metapi는 어떻게 설치하나요?
프로젝트 폴더를 만듭니다: mkdir metapi && cd metapi README 설정을 사용해 docker-compose.yml 파일을 만듭니다 관리자 토큰과 프록시 토큰을 설정한 다음 컨테이너를 시작합니다: export AUTH_TOKEN=your-admin-token && export PROXY_TOKEN=your-proxy-sk-token && docker compose up -d http://localhost:4000을 열고 AUTH_TOKEN으로 로그인합니다
metapi은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cita-777/metapi

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트