QuantumNous/new-api

어떤 프로젝트인가요?

핵심 기능

• 01동일한 업스트림 모델을 대상으로 OpenAI, Anthropic Messages, Gemini 호환 엔드포인트 제공
• 02모델 매핑, 우선순위, 가중치, 재시도를 사용해 여러 채널로 요청 라우팅
• 03사용량 로그와 비용 정산을 통해 사용자, 그룹, API 키, 할당량 관리
• 04콘솔 로그인에 OAuth/OIDC, 패스키, 2단계 인증 지원
• 05JavaScript 플러그인으로 비동기 이미지·동영상 및 기타 작업 API 확장

활용 사례

• 사용자별 할당량과 사용량 추적을 적용해 팀에 승인된 모델 액세스 공유
• 각 클라이언트 애플리케이션을 재구성하지 않고 업스트림 제공업체 전환
• 관리자용 웹 콘솔을 갖춘 비공개 멀티 모델 서비스 운영

빠른 시작

1. 1

   Docker로 로컬 인스턴스를 시작합니다(SQLite 사용, localhost에 바인딩).

   mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest
2. 2

   http://localhost:3000 을 열고 설정 마법사를 완료해 관리자 계정을 만듭니다.

3. 3

   업스트림 API 키로 채널을 추가하고 모델과 가격을 설정한 다음 새 API 키를 만듭니다.

4. 4

   키를 사용해 사용 가능한 모델을 나열합니다.

   curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

사용 전 알아둘 점

• !업스트림 API 키와 계정은 직접 준비해야 하며, 업스트림 서비스 약관을 준수해야 합니다.
• !생성형 AI 또는 API를 공개적으로 제공하거나 재판매하는 경우 상당한 법률·신고·컴플라이언스 의무가 따릅니다.
• !AGPL-3.0 라이선스가 적용됩니다. 네트워크 사용 시 소스 공개 의무가 있는 카피레프트 라이선스입니다.

토픽

자주 묻는 질문

new-api은(는) 무엇인가요?

여러 업스트림 모델 제공업체를 대상으로 라우팅, 키, 할당량, 비용 추적을 제공하며 OpenAI, Claude, Gemini 호환 API를 노출하는 셀프 호스팅 AI 게이트웨이입니다. New API는 애플리케이션과 OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, Vertex AI, DeepSeek 같은 업스트림 모델 서비스 사이에서 동작하는 셀프 호스팅 게이트웨이입니다. 클라이언트는 일관된 하나의 API를 호출하고, 게이트웨이는 OpenAI Chat/Responses, Anthropic Messages, Gemini 요청 형식 간 변환을 처리합니다.

new-api은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

new-api은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

new-api은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. new-api의 마지막 커밋은 2026년 10월 19일입니다.

new-api은(는) 어디에 사용할 수 있나요?

사용자별 할당량과 사용량 추적을 적용해 팀에 승인된 모델 액세스 공유 각 클라이언트 애플리케이션을 재구성하지 않고 업스트림 제공업체 전환 관리자용 웹 콘솔을 갖춘 비공개 멀티 모델 서비스 운영

new-api는 어떻게 설치하나요?

Docker로 로컬 인스턴스를 시작합니다(SQLite 사용, localhost에 바인딩).: mkdir -p data docker run --name new-api -d --restart unless-stopped \ -p 127.0.0.1:3000:3000 \ -e TZ=Asia/Shanghai \ -v "$(pwd)/data:/data" \ calciumion/new-api:latest http://localhost:3000 을 열고 설정 마법사를 완료해 관리자 계정을 만듭니다. 업스트림 API 키로 채널을 추가하고 모델과 가격을 설정한 다음 새 API 키를 만듭니다. 키를 사용해 사용 가능한 모델을 나열합니다.: curl --fail-with-body http://localhost:3000/v1/models \ -H "Authorization: Bearer ${NEW_API_KEY}"

new-api은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/QuantumNous/new-api