API-Route란 무엇인가요?
API-Route는 모델 호출, 라우팅, 가격, 잔액, 사용 로그를 하나의 계정에서 관리하는 OpenAI 호환 멀티 모델 AI API입니다.
API-Route란
제품의 역할
API-Route는 OpenAI 호환 멀티 모델 AI API입니다. 하나의 Base URL과 API 키로 지원 모델을 호출해 공급자별 연결 설정을 따로 관리하는 부담을 줄일 수 있습니다.
모델 가격, 계정 잔액, 플랜, 요청 로그도 같은 계정에서 확인할 수 있습니다.
- 하나의 Base URL과 API 키로 지원 모델 호출
- 모델 가격과 제공 상태를 한곳에서 확인
- 잔액과 요청 로그 통합 관리
대상 사용자, 모델, 애플리케이션
AI 애플리케이션 개발, SaaS 연동, 여러 모델을 하나의 방식으로 호출하려는 개발자와 팀에 적합합니다.
- 모델
- 지원 모델은 변경될 수 있으므로 고정 목록 대신 가격 페이지의 실시간 표시를 기준으로 확인하세요.
- 도구
- Codex, Claude Code, LibreChat, VS Code 및 앱 페이지에 등록된 다른 도구의 연결 안내를 제공합니다.
API-Route 작동 방식
4단계 사용 흐름
- 계정 가입 잔액과 API 키를 관리할 계정을 만듭니다. Google, X 또는 GitHub 계정으로 가입하고 로그인할 수도 있습니다.
- 잔액 충전 또는 플랜 구매 충전 페이지에 현재 표시되는 결제 방식을 사용한 뒤 종량 잔액 또는 이용 가능한 플랜을 선택합니다.
- API 키 생성 API 키 페이지에서 활성 키를 만들고 안전하게 저장합니다.
- 모델 선택 후 호출 키에서 사용할 수 있는 정확한 모델 ID를 지정해 설정된 엔드포인트로 요청합니다.
API 키 관리 및 접근 제어
API 키마다 설정을 분리해 애플리케이션과 환경별로 사용 한도와 접근 조건을 관리할 수 있습니다.
- 할당량 및 만료
- 무제한 또는 고정 할당량을 설정하고, 특정 만료 시간이나 무기한 사용을 선택할 수 있습니다.
- 라우팅 우선순위
- 토큰 가격 우선 또는 호출당 가격 우선을 선택할 수 있습니다. 실제 라우트는 선택한 모델과 현재 백엔드 상태에 따라 달라집니다.
- 모델 허용 목록
- 현재 등록된 모델 중 지정한 모델만 호출하도록 제한할 수 있습니다. 비워 두어도 키 그룹과 현재 등록 상태에 따른 제한은 적용됩니다.
- IP 허용 목록
- 하나 이상의 IP 주소 또는 CIDR 대역을 지정할 수 있습니다. 비워 두면 접속 IP를 제한하지 않습니다.
- 키 그룹 및 지원 모델
- 키 그룹이 제공되는 경우 그룹별 키를 생성하고 가격과 현재 호출 가능한 모델을 확인할 수 있습니다.
- 키 수명 주기
- 키별로 수정, 활성화, 비활성화 또는 삭제할 수 있습니다. 새 시크릿은 한 번만 표시되므로 안전하게 보관해야 합니다.
통합 인터페이스 방식
Base URL은 연결 주소, API 키는 요청 인증, 모델 ID는 모델 선택에 사용합니다. 잔액, 사용량, 요청 로그는 같은 계정에서 관리됩니다.
- Base URL
- OpenAI 호환 연결을 지원하는 클라이언트와 SDK가 사용하는 엔드포인트입니다.
- API 키
- API 요청 인증을 위해 계정에서 생성하는 자격 증명입니다.
- 모델 ID
- 요청에서 모델을 선택할 때 사용하는 현재의 정확한 식별자입니다.
- 계정과 로그
- 잔액, 사용량, 요청 기록을 한곳에서 확인합니다.
다중 라우팅과 장애 전환
다중 라우팅 구조
같은 모델에 하나 이상의 사용 가능한 라우트 노드를 구성할 수 있습니다. 가격 페이지의 “1 route”, “2 routes”, “3 routes”는 해당 모델에서 현재 사용할 수 있는 라우트 수를 뜻합니다.
- 여러 라우트는 하나의 업스트림 노드에 대한 의존도를 낮출 수 있습니다.
- 모든 모델이 여러 라우트를 제공하는 것은 아닙니다.
- 실제 라우트 수는 가격 페이지의 실시간 표시를 기준으로 합니다.
장애 전환과 기능 범위
현재 라우트에서 오류, 시간 초과, 일시적인 이용 불가가 발생하면 정해진 라우팅 정책에 따라 재시도하거나 다른 사용 가능한 라우트로 전환할 수 있습니다.
- 다중 라우팅은 단일 노드 장애의 영향을 줄이는 데 도움이 됩니다.
- 장애 전환이 무중단을 보장하거나 모든 모델에 항상 예비 라우트가 있음을 의미하지는 않습니다.
- 실제 라우트 제공 상태는 모델과 시점에 따라 달라집니다.
사용자 요청 → 사용 가능한 라우트 선택 → 오류 시 재시도 또는 예비 라우트 전환
가격과 비용
API 과금 방식
과금 단위는 모델마다 다릅니다. 실제 차감액은 가격 페이지, 계정 기록, 요청 로그를 기준으로 합니다.
- 입력 토큰
- 토큰 과금 모델에 보내는 텍스트 또는 컨텍스트입니다.
- 출력 토큰
- 모델이 생성한 텍스트입니다.
- 캐시 비용
- 지원 모델은 캐시 읽기와 캐시 생성을 별도로 과금할 수 있습니다.
- 호출 및 미디어 사양 과금
- 이미지, 오디오, 비디오 등은 호출, 시간, 해상도 또는 표에 표시된 다른 사양으로 과금될 수 있습니다.
- 잔액과 플랜
- 사용량은 계정 잔액 또는 이용 가능한 플랜의 조건과 한도에 따라 차감됩니다.
공식 참고 가격보다 낮을 수 있는 이유
API-Route는 여러 사용 가능한 업스트림 공급 채널과 라우트 노드에 연결합니다. 채널마다 대량 구매, 제휴 정산, 비용 구조가 다를 수 있습니다.
- 단위 비용
- 호출량 집계, 공유 인프라, 자동 라우팅으로 호출당 비용을 낮출 수 있습니다.
- 공식 참고 가격
- 공식 가격은 모델 공급자가 공개한 소매 가격이며 비용 비교 기준으로 사용합니다.
- 라우트 차이
- 라우트마다 가격, 지연 시간, 한도, 컨텍스트 기능, 가용성이 다를 수 있습니다. 낮은 가격이 공식 직접 연결과 모든 특성이 같다는 뜻은 아닙니다.
API-Route와 다른 선택지
각 방식에는 적합한 사용 사례가 있습니다. 아래 비교는 공급자 서비스 품질의 순위를 매기지 않고 계정 관리와 연결 방식의 차이에 초점을 둡니다.
API-Route와 공식 모델 API의 차이
OpenAI, Anthropic, Google 등의 공식 API는 각 공급자가 직접 제공하는 서비스입니다. API-Route는 여러 공급자를 사용할 때 필요한 관리를 하나의 계정으로 모으는 데 초점을 둡니다.
| 비교 항목 | API-Route | 공식 모델 API |
|---|---|---|
| 공급자 계정 | 하나의 API-Route 계정 | 선택한 공급자마다 별도 가입 |
| Base URL과 API 키 | 하나의 호환 API와 키 관리 흐름 | 공급자별 엔드포인트와 인증 정보 |
| 모델 가격 | 하나의 가격 페이지에서 비교 | 각 공급자 가격 페이지에서 확인 |
| 잔액과 요청 로그 | 한 계정에서 통합 관리 | 각 공급자 콘솔에서 개별 관리 |
| 클라이언트 설정 | 호환 연결을 재사용하고 모델 ID 전환 | 공급자 연동을 각각 설정 |
API-Route는 OpenRouter의 대안인가요?
API-Route와 OpenRouter는 여러 모델을 통합해 사용하려는 이용자를 위한 서비스라는 점에서 방향이 비슷합니다. OpenRouter도 멀티 모델 통합 인터페이스, OpenAI SDK 호환, 공급자 라우팅을 제공하므로 이러한 기능은 API-Route만의 기능이 아닙니다.
| 비교 항목 | API-Route | OpenRouter |
|---|---|---|
| 멀티 모델 통합 API | API-Route에 현재 등록된 모델 이용 | 자체 모델 카탈로그와 공급자 라우팅 제공 |
| OpenAI API 호환성 | OpenAI 호환 API와 Base URL 제공 | OpenAI SDK 호환 사용 지원 |
| 결제 방식 | 충전 페이지에 현재 표시되는 방식을 사용 | 지원 방식과 지역은 현재 OpenRouter 결제 페이지에서 확인 |
| 플랜과 잔액 | 계정 잔액과 현재 이용 가능한 플랜 지원 | 현재 OpenRouter 크레딧 및 결제 조건과 비교 |
| 클라이언트 연결 | Codex, Claude Code 등 지원 도구용 설정 흐름 제공 | 클라이언트와 OpenRouter의 최신 안내에서 사용자 지정 연결 지원 확인 |
| 현지화와 지원 | 4개 언어 페이지와 사이트에 표시된 지원 채널 제공 | OpenRouter의 현재 언어와 공식 지원 채널 확인 |
두 서비스의 방향은 비슷합니다. 결제 방식, 플랜과 잔액 선호, 클라이언트 설정, 현지화 지원, 실제로 필요한 모델을 기준으로 선택할 수 있습니다.
시작하기
사용 방식 선택
- AI Chat
- 사이트 웹 채팅에서 해당 제품에 현재 제공되는 모델을 사용합니다.
- API 연동
- 애플리케이션, SDK, 스크립트 또는 지원 클라이언트를 API에 연결합니다.
- 독립 플랫폼
- 자체 사용자용 별도 진입점이 필요할 때 기존 독립 사이트 기능을 사용합니다.
다음 단계
상세 설정을 확인하고 현재 모델 비용을 비교하거나 계정을 만들어 시작하세요.