Repolode
제출하기
fruitbars

fruitbars/simple-one-api

여러 LLM 제공업체를 OpenAI, Responses 및 Anthropic 호환 엔드포인트 하나로 연결하는 자체 호스팅 게이트웨이로, 단일 실행 파일로 배포됩니다.

대체할 수 있는 제품:OpenRouter

GitHub에서 보기
스타
2,345
포크
210
열린 이슈
47
마지막 커밋
지난달

어떤 프로젝트인가요?

simple-one-api는 클라이언트 도구와 여러 대규모 언어 모델 제공업체 사이에서 동작하는 게이트웨이입니다. 클라이언트는 OpenAI Chat Completions, OpenAI Responses 또는 Anthropic Messages 프로토콜을 사용해 단일 엔드포인트에 요청하고, 게이트웨이는 요청을 Qianfan, iFlytek Spark, Tencent Hunyuan, MiniMax, DeepSeek 등의 설정된 제공업체로 전달합니다.

각 제공업체는 여러 API 키를 풀로 관리할 수 있습니다. 게이트웨이는 요청별 토큰 비용을 추정하고, 키와 모델별로 최근 60초간의 용량을 추적합니다. 업스트림에서 429 응답이 오면 다른 키로 전환하며, 쿨다운 및 복구 시간은 관리자 콘솔에서 확인할 수 있습니다. 속도 제한은 제공업체, 제공업체-모델, 키, 키-모델 단위로 설정할 수 있습니다.

프로젝트는 React 웹 채팅이 내장된 단일 바이너리로 제공되며, SQLite 기반 설정 콘솔, 사용량 통계 화면, 루프백 인터페이스에서 로컬 게이트웨이를 실행하는 Wails 데스크톱 앱도 포함합니다. GitHub Release 아카이브와 멀티 아키텍처 Docker 이미지로 배포됩니다.

핵심 기능

  • 01하나의 게이트웨이에서 OpenAI Chat Completions, Responses 및 Anthropic Messages 엔드포인트를 제공합니다.
  • 02제공업체별로 여러 API 키를 풀링하고 라운드 로빈, 우선 지정, 무작위, 해시 방식으로 라우팅합니다.
  • 03키별 토큰 용량을 추정하고 업스트림에서 429 응답이 오면 다른 키로 전환합니다.
  • 04QPS, QPM, RPM, TPM 및 동시 실행 수에 단계별 제한을 적용합니다.
  • 05웹 채팅과 키 상태를 실시간으로 확인할 수 있는 설정 콘솔을 내장합니다.
  • 06설정은 SQLite에 저장하고, 프롬프트나 응답 본문은 저장하지 않으면서 사용량 통계를 제공합니다.

활용 사례

  • Codex나 Claude Code 같은 로컬 클라이언트 여러 개에서 게이트웨이 키 하나를 공유합니다.
  • 여러 업스트림 키로 많은 트래픽을 분산해 429 오류를 줄입니다.
  • 중국 LLM 제공업체 여러 곳에 연결하는 비공개 자체 호스팅 진입점을 운영합니다.
  • 소규모 팀에 사용량을 확인할 수 있는 단일 OpenAI 호환 엔드포인트를 제공합니다.

빠른 시작

  1. 1

    소스에서 단일 실행 파일을 빌드합니다

    ./quick_build.sh
  2. 2

    gateway를 실행합니다. 최초 설정에는 config.json이 필요하지 않습니다

    ./simple-one-api
  3. 3

    브라우저에서 http://localhost:9090/을 열고 /setup 마법사를 완료합니다

사용 전 알아둘 점

  • 소스에서 빌드하려면 Go 1.25 이상, Node.js 및 pnpm이 필요합니다.
  • 요금, 무료 사용량 및 모델 세부 정보는 upstream 제공업체에서 제공하며 변경될 수 있으므로, README에서는 각 제공업체의 공식 문서를 확인하도록 안내합니다.

포함된 컬렉션

셀프 호스팅 앱

토픽

#llm-gateway#openai-compatible#api-proxy#load-balancing#rate-limiting#self-hosted#golang

자주 묻는 질문

simple-one-api은(는) 무엇인가요?
여러 LLM 제공업체를 OpenAI, Responses 및 Anthropic 호환 엔드포인트 하나로 연결하는 자체 호스팅 게이트웨이로, 단일 실행 파일로 배포됩니다. simple-one-api는 클라이언트 도구와 여러 대규모 언어 모델 제공업체 사이에서 동작하는 게이트웨이입니다. 클라이언트는 OpenAI Chat Completions, OpenAI Responses 또는 Anthropic Messages 프로토콜을 사용해 단일 엔드포인트에 요청하고, 게이트웨이는 요청을 Qianfan, iFlytek Spark, Tencent Hunyuan, MiniMax, DeepSeek 등의 설정된 제공업체로 전달합니다.
simple-one-api은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
simple-one-api은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
simple-one-api은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. simple-one-api의 마지막 커밋은 2026년 9월 29일입니다.
simple-one-api은(는) 어디에 사용할 수 있나요?
Codex나 Claude Code 같은 로컬 클라이언트 여러 개에서 게이트웨이 키 하나를 공유합니다. 여러 업스트림 키로 많은 트래픽을 분산해 429 오류를 줄입니다. 중국 LLM 제공업체 여러 곳에 연결하는 비공개 자체 호스팅 진입점을 운영합니다. 소규모 팀에 사용량을 확인할 수 있는 단일 OpenAI 호환 엔드포인트를 제공합니다.
simple-one-api는 어떻게 설치하나요?
소스에서 단일 실행 파일을 빌드합니다: ./quick_build.sh gateway를 실행합니다. 최초 설정에는 config.json이 필요하지 않습니다: ./simple-one-api 브라우저에서 http://localhost:9090/을 열고 /setup 마법사를 완료합니다
simple-one-api은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/fruitbars/simple-one-api

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

관련 프로젝트