RouterHub가 제공하는 것
RouterHub는 OpenRouter의 대안으로 소개되며, 실시간 모델 카탈로그와 API 액세스 워크플로를 제공합니다. 이 저장소는 모델 탐색, API 사용, 마이그레이션, 가격, 변형 모델, 사용 사례, 안전, 문제 해결을 다루는 문서 허브 역할을 합니다.
문서는 주제별 가이드가 순서대로 구성되어 있습니다. 처음부터 끝까지 읽거나, 작업에 맞는 주제로 바로 이동할 수 있습니다.
적절한 시작점 선택
- 서비스 평가: OpenRouter 대안이란 무엇인가?와 RouterHub와 OpenRouter 비교부터 시작하세요.
- 마이그레이션 계획: 문서에 명시된 기본 URL, API 키, 모델 매핑 절차는 마이그레이션 가이드에서 확인하세요.
- 모델 찾기: 모델 카탈로그 가이드와 실시간 카탈로그에서 모델군, ID, 프로토콜을 확인하세요.
- 첫 요청 보내기: API 빠른 시작을 따르세요.
- 비용 확인: 토큰당 예시는 가격에서 확인하세요.
- 변형 모델 비교: 검열 제거 및 얼리터레이티드 모델 가이드를 참고하세요.
액세스 설정
- RouterHub 등록 페이지를 열고 온보딩 절차에 따라 API 키를 발급받으세요.
- 애플리케이션에 필요한 정확한 모델 ID와 지원 프로토콜을 확인하려면 모델 카탈로그 문서를 검토하세요.
- 기존 OpenRouter 통합을 마이그레이션하는 경우, 문서에 명시된 기본 URL, 키 처리, 모델 매핑은 마이그레이션 가이드를 참고하세요.
- API 빠른 시작을 사용해 첫 요청을 구성하고 전송하세요.
API 키를 안전하게 관리하세요. 소스 코드에 직접 입력하지 말고 환경 변수나 다른 비밀 관리 시스템에 저장하세요.
올바른 모델 찾기
모델 선택은 RouterHub 워크플로에서 중요한 부분입니다. 이 저장소는 모델군, 모델 ID, 프로토콜을 다루는 카탈로그 가이드를 제공합니다. 식별자를 추측하지 말고 해당 가이드와 실시간 모델 카탈로그를 함께 사용하세요.
실용적인 선택 절차는 다음과 같습니다.
- 코딩, 에이전트 워크플로, 리서치, 글쓰기 등 작업을 정의합니다.
- 사용 가능한 모델군과 변형 모델 정보를 살펴봅니다.
- 카탈로그에 표시된 정확한 모델 ID를 복사합니다.
- 모델의 프로토콜이 사용할 클라이언트 또는 통합 방식과 일치하는지 확인합니다.
- 프로덕션 트래픽을 보내기 전에 가격 문서를 확인합니다.
첫 API 요청 보내기
이 저장소는 첫 요청을 위해 API 빠른 시작 가이드를 안내합니다. 정확한 엔드포인트와 요청 형식은 해당 가이드에서 관리되므로, 다른 예제에 있는 엔드포인트를 하드코딩하지 말고 현재 가이드의 값을 사용하세요.
요청 설정에는 일반적으로 다음과 같이 문서에 명시된 값이 필요합니다.
API key: <RouterHub API 키>
Base URL: <RouterHub API 빠른 시작에 있는 값>
Model ID: <모델 카탈로그의 정확한 ID>
Protocol: <선택한 모델이 지원하는 프로토콜>구체적인 구현 방법은 API 빠른 시작을 열어 요청 예제를 복사하고, API 키를 안전하게 설정한 다음, 카탈로그에서 선택한 정확한 ID로 모델 값을 바꾸세요.
기존 OpenRouter 통합 마이그레이션
애플리케이션에서 이미 OpenRouter를 사용하고 있다면 저장소의 마이그레이션 가이드를 따르세요. README에서는 기본 URL 변경, RouterHub API 키 사용, 모델 식별자 매핑이라는 세 가지 마이그레이션 항목을 설명합니다.
테스트하기 전에 다음 체크리스트를 사용하세요.
- 마이그레이션 문서에 따라 공급자 기본 URL을 업데이트합니다.
- 기존 자격 증명을 RouterHub API 키로 교체합니다.
- 각 모델 이름을 검토하고 정확한 RouterHub 모델 ID로 매핑합니다.
- 선택한 모델이 요구하는 프로토콜을 확인합니다.
- 통합을 프로덕션으로 이전하기 전에 소규모 테스트 요청을 보냅니다.
전환 이유에 대한 추가 맥락은 전환해야 하는 이유에서 확인하세요. 이 문서는 선불 결제, 모델 ID, 검열되지 않은 옵션을 다룹니다.
가격 및 변형 모델 검토
가격
가격 가이드에서는 토큰당 예시를 설명합니다. 이를 사용해 예상 워크로드의 비용을 추정하고 요청을 확장하기 전에 모델을 비교하세요.
검열 제거 및 얼리터레이티드 모델
검열 제거 및 얼리터레이티드 모델 가이드는 이러한 변형 모델을 비교하기 위한 것입니다. 저장소의 안전 가이드도 읽고, 모든 모델을 합법적이고 책임감 있게 사용하세요.
실용적인 사용 사례 살펴보기
첫 요청이 정상적으로 작동한 후에는 사용 사례 가이드에서 코딩, 에이전트, 리서치, 글쓰기를 다룹니다. 이 예제를 활용해 구축하려는 애플리케이션의 유형에 맞는 모델군과 프로토콜을 선택하세요.
운영 관련 질문은 문제 해결 가이드를 참조하세요. 이 가이드에서는 인증, 모델 ID, 프로토콜을 중점적으로 다룹니다. FAQ에서는 더 자세한 답변을 제공하며, 용어집에서는 문서 전반에서 사용되는 용어를 설명합니다.
고급 팁
- 정확한 ID를 우선 사용하세요: 이름 차이로 인한 오류를 방지하려면 카탈로그에서 모델 식별자를 복사하세요.
- 프로토콜을 먼저 확인하세요: 애플리케이션 코드를 디버깅하기 전에 프로토콜 호환성을 검증하세요.
- 구성과 코드를 분리하세요: API 키, 기본 URL, 모델 ID를 구성 가능하게 유지하면 마이그레이션과 테스트가 쉬워집니다.
- 먼저 비용을 추정하세요: 대규모 작업을 실행하기 전에 토큰당 가격 예시를 활용하세요.
- 문서 경로를 활용하세요: 모든 통합 문제를 일반적인 API 문제로 다루기보다 마이그레이션, 빠른 시작, 가격 또는 문제 해결 가이드를 선택하세요.
- 안전성을 검토하세요: 검열되지 않았거나 보호 기능이 제거된 변형을 평가할 때는 안전 지침을 읽고 합법적인 용도로만 사용을 제한하세요.
결론
RouterHub 저장소는 OpenRouter 대안을 평가하고 해당 API를 통합하기 위한 체계적인 출발점입니다. 먼저 API 키를 발급받고, 카탈로그에서 정확한 모델 ID를 선택한 다음, 프로토콜을 확인하고 API 빠른 시작 가이드를 따르세요. 기존 애플리케이션을 마이그레이션하는 경우 전용 마이그레이션 가이드를 사용한 후 배포 전에 가격, 변형, 안전성 및 문제 해결 관련 사항을 검증하세요.