One API

다양한 LLM 제공업체 지원

OpenAI, Azure OpenAI, Anthropic Claude, Google Gemini, DeepSeek, 字节豆包, ChatGLM, 文心一言, 讯飞星火, 通义千问, 360智脑, 腾讯混元 등 주요 LLM 제공업체를 지원합니다. 각 제공업체의 API 키를 등록하고 관리할 수 있습니다.

통합 API 엔드포인트

모든 제공업체를 OpenAI API 형식의 단일 엔드포인트로 통합합니다. 클라이언트는 OpenAI API와 동일한 방식으로 요청을 보낼 수 있으며, One API가 내부적으로 각 제공업체에 맞게 요청을 변환합니다.

키 관리 및 재배포

사용자에게 발급할 토큰을 생성하고, 토큰별로 만료 시간, 사용 한도, 허용 IP 범위, 접근 가능한 모델을 설정할 수 있습니다. 또한 사용자 그룹과 채널 그룹을 설정하여 각 그룹별로 다른 배율을 적용할 수 있습니다.

부하 분산 및 고가용성

여러 채널을 등록하고 부하 분산 방식으로 요청을 분산할 수 있습니다. 또한 다중 서버 배포를 지원하여 대규모 트래픽을 처리할 수 있습니다.

사용자 관리 및 인증

이메일, GitHub, Feishu 등 다양한 로그인 방식을 지원하며, 사용자 그룹과 초대 보상 기능을 제공합니다. Cloudflare Turnstile을 통한 사용자 검증도 지원합니다.

커스터마이징

시스템 이름, 로고, 페이지 하단을 사용자 정의할 수 있으며, 홈페이지와 소개 페이지를 HTML 또는 Markdown으로 꾸밀 수 있습니다. 테마도 변경 가능합니다.

Docker로 설치

Docker를 사용하면 다음 명령으로 One API를 실행할 수 있습니다:

docker run --name one-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api

위 명령은 SQLite를 사용하며, 데이터는 호스트의 /home/ubuntu/data/one-api 디렉토리에 저장됩니다. MySQL을 사용하려면 SQL_DSN 환경 변수를 추가하세요.

단일 바이너리로 설치

GitHub Releases에서 실행 파일을 다운로드하거나 소스에서 빌드할 수 있습니다. 빌드 후 다음 명령으로 실행합니다:

./one-api --port 3000 --log-dir ./logs

그런 다음 http://localhost:3000에 접속하고 기본 계정 root / 123456으로 로그인합니다.

기본 사용법

로그인 후 ‘채널’ 페이지에서 각 제공업체의 API 키를 추가하고, ‘토큰’ 페이지에서 사용자에게 발급할 토큰을 생성합니다. 이후 OpenAI API와 동일한 방식으로 One API의 엔드포인트에 요청을 보내면 됩니다.

One API는 어떤 LLM 제공업체를 지원하나요?

OpenAI, Azure OpenAI, Anthropic Claude, Google Gemini, DeepSeek, 字节豆包, ChatGLM, 文心一言, 讯飞星火, 通义千问, 360智脑, 腾讯混元 등 다양한 제공업체를 지원합니다. 자세한 목록은 공식 문서를 참조하세요.

Docker로 어떻게 실행하나요?

Docker Hub에서 justsong/one-api 이미지를 받아 실행할 수 있습니다. 예: docker run -d -p 3000:3000 justsong/one-api

기본 로그인 계정은 무엇인가요?

기본 계정은 root이고 비밀번호는 123456입니다. 첫 로그인 후 반드시 비밀번호를 변경하세요.