Cursor, Claude Code, 스크립트 몇 줄이면 base URL을 「OpenAI 호환 엔드포인트 하나」로 맞출 수 있습니다. 클라이언트 형태는 같아 보입니다. 청구서와 장애는 같지 않습니다. OmniRoute는 직접 돌리는 머신 위에서 이미 가입한 프로바이더 키를 묶고, auto나 combo로 다음 홉을 고릅니다. OpenRouter는 호스팅 키 하나를 줍니다. 요청은 그들의 인프라를 지나 등록된 프로바이더로 갑니다. 2026년 10월에도 여전히 두 선택을 「누가 모델을 더 많이 적어 놨나」로 합쳐 쓰고, 무료 한도 스크린샷을 프로덕션 경로로 올리는 경우가 있습니다. 카탈로그 길이는 세 가지 검증에 답하지 못합니다. 상위 키를 누가 쥐는지, 프롬프트가 어디에 남는지, 무료 할당이 끝난 뒤 누가 요청을 받는지입니다.
이 가이드는 코딩 에이전트, 내부 도구, 프로토타입을 연결하는 사람을 위합니다. 아래 숫자는 2026-10-28에 확인한 공개 문서를 따릅니다: OmniRoute 무료 한도 가이드와 Auto-Combo 위키, OpenRouter 요금 페이지와 FAQ. 프로바이더 한도는 바뀝니다. 발주서에 숫자를 넣기 전에 공식 페이지를 다시 열어 보세요.
왜 API 하나로 모델 라우팅이 끝나지 않나
옛 구조는 도구마다 키가 하나씩입니다. 에디터는 OpenAI, 스크립트는 Gemini, 밤 배치는 그 주에 가장 싼 곳으로 바꿉니다. 키는 노트북 키체인, CI 시크릿, 동료 shell 프로필에 흩어집니다. 한 벤더가 429를 내면 모든 클라이언트를 고칩니다. 정책 한 곳을 고치는 게 아닙니다.
새 구조는 그 사이에 한 겹을 끼웁니다. 클라이언트는 base URL 하나와 게이트웨이 키 하나만 압니다. 실제 프로바이더 키, 재시도, 「이 할당이 죽으면 다음은 누구」 목록은 그 겹에 남습니다. 갈등은 어느 모델이 더 똑똑한지가 아닙니다. 그 겹을 누가 운영하는지입니다. 자체 호스팅이면 프로세스, 로그, 폴백 순서를 당신이 갖고, 머신이 잠들면 겹 전체가 사라집니다. 호스팅이면 프로세스를 볼 필요는 줄지만, 프롬프트와 사용량 메타데이터가 다른 사람의 네트워크를 지나고, 무료 플랜에서 켤 수 있는 스위치는 더 적습니다.
그래서 OmniRoute 대 OpenRouter는 또 하나의 Claude vs GPT 싸움이 아닙니다. 둘 다 여러 모델 계열로 요청을 보낼 수 있습니다. 갈라지는 곳은 상위 계약을 당신이 쥐고 라우트를 쓰는지, 호스트가 라우트와 청구를 맡는지입니다.
코딩 에이전트가 여섯 시간 돌아가는 순간 그 차이가 드러납니다. 노트북의 로컬 게이트웨이는 자정에 덮개가 닫히면 진행 중인 도구 호출이 connection reset으로 죽는 것처럼 「공짜」로 보입니다. 호스팅 게이트웨이는 비싸 보이다가, 자체 프로세스를 다시 띄우고 키를 돌리고 「어제 base URL이 왜 안 되나」를 설명하는 시간을 더하면 달라집니다. 토큰만이 아니라 운영자 비용을 매기세요.
네 겹: AI 게이트웨이, 모델 라우팅, API 집약, 무료 한도
네 문구를 한 슬로건에 쌓으면 선택이 틀어집니다. 서로 다른 질문에 답합니다. 빠진 답은 출시 후 메울 세부가 아니라, 아직 정의되지 않은 요구사항으로 두세요.
AI 게이트웨이
게이트웨이는 문입니다. 인증, chat-completions 형태 하나, 로그, 타임아웃. OmniRoute 기본 OpenAI 호환 문은 돌리는 머신의 http://localhost:20128/v1입니다. OpenRouter 문은 그들의 호스트에 있습니다. 클라이언트는 base URL과 발급받은 키를 바꿉니다. 문 앞은 같아 보입니다. 문 뒤 머신은 당신 것이 아닙니다.
모델 라우팅
라우팅은 이번 호출이 어느 계정·어느 모델로 가고, 실패 후 누구를 시도하는지를 정합니다. OmniRoute 대시보드에서 흔한 계정 수준 전략은 Fill First, Round Robin, P2C, Random, Least Used, Cost Optimized입니다. Combo와 auto 접두사로 priority, weighted, least-used, cost-optimized, lkgp(마지막으로 성공한 프로바이더 유지), context-optimized도 씁니다. combo를 저장하지 않았을 때는 auto, auto/coding, auto/fast, auto/cheap, auto/offline을 호출할 수 있습니다. OpenRouter의 자동 라우팅, preferred providers, budgets, prompt caching은 유료 플랜에 있습니다. 공개 요금표 Free 열에는 해당 제어가 No로 표시됩니다.
API aggregation
집약은 여러 프로바이더 앞에 클라이언트 프로토콜 하나를 두는 것입니다. OmniRoute는 당신이 설정한 연결을 묶습니다. 공식 무료 한도 가이드는 분명합니다. 프로젝트는 광고되는 통합 토큰 예산을 발급하지 않습니다. 계정이 필요한 곳은 여전히 가입해야 하고, 새 설치에는 키 없이 쓸 수 있는 대상이 0개일 수 있습니다. OpenRouter는 등록한 모델을 묶습니다. 요금표 Standard 열은 500+ 모델, 80+ 프로바이더입니다. BYOK로 바꾸지 않으면 각각과 키를 맺지 않습니다.
무료 한도
무료는 두 장의 장부입니다. 무료 소프트웨어가 무료 추론은 아닙니다. OmniRoute는 MIT 라이선스입니다. 게이트웨이 프로세스가 토큰당 청구하지 않습니다. 머신 비용과 상위가 자체 할당 뒤에 부과하는 비용을 냅니다. OpenRouter 무료 플랜은 계정 상한입니다: 25개 이상 무료 모델, 4개 무료 프로바이더, 하루 50회 요청, activity log는 켜짐, 자동 라우팅은 꺼짐. FAQ에는 최소 10 credits를 구매하면 무료 모델이 하루 1,000회로 올라간다고 나옵니다. openrouter/free도 있어 무료 모델 중 하나를 고릅니다. 그 스위치는 OmniRoute의 auto/cheap과 같지 않습니다. 하나는 호스팅 무료 풀, 다른 하나는 당신이 붙인 연결 집합입니다.
입구·실행·컨텍스트를 한 표로
모델 목록이 분수령이 아닙니다. 키를 누가 쥐는지, 실패를 누가 흡수하는지, 무료 한도가 어느 장부에 잡히는지가 분수령입니다. 표에서 실행(execution)은 요청이 어떻게 전달·재시도되는지를 뜻합니다. 게이트웨이가 저장소를 고친다는 뜻은 아닙니다.
| 도구 | 입구 | 실행 | 컨텍스트 | 맞는 사람 |
|---|---|---|---|---|
| OmniRoute | 직접 돌리는 프로세스. 로컬 기본 localhost:20128/v1, 또는 항상 켜 두는 머신의 같은 포트 |
추가한 연결 사이 폴백. Fill First, 라운드 로빈, P2C, 최저 비용, 또는 auto/coding·auto/cheap |
프로바이더 키, 라우트 상태, 로그는 당신 머신에. 프롬프트는 기본적으로 호스팅 게이트웨이를 지나지 않음 | 게이트웨이를 운영할 의향이 있고, 자체 무료 한도나 유료 키를 한 클라이언트 URL 뒤에 쌓을 사람 |
| OpenRouter | 호스팅 base URL과 그들이 발급한 키. Free부터 Enterprise까지 같은 형태의 문 | 자동 라우팅·preferred providers는 유료부터. Free는 자동 라우팅 없이 하루 50회, 또는 최소 10 credits 후 무료 모델 하루 1,000회 | 요청과 사용량 메타데이터는 OpenRouter를 지남. Standard는 prompt caching·budgets. EU/US in-region routing은 Business | 프로세스를 보지 않을 팀. 크레딧 충전에 5.5% 플랫폼 수수료와 프로바이더 정가를 받아들이는 경우 |
OpenRouter Standard 플랫폼 수수료는 5.5%, Business는 8%입니다. BYOK는 월 정가 추론 $25,000까지 플랫폼 수수료 없음, 이후 5%입니다. 그 수수료는 통로 비용이지 모델 토큰 할인이 아닙니다. OmniRoute에는 맞는 플랫폼 수수료가 없고, 머신·백업·인증서·폴백 순서에 쓰는 시간은 여전히 셉니다. 머신 규모는 OmniRoute 클라우드 배포 비용을, 대시보드 합계가 개인 무제한이 아닌 이유는 무료 한도·모델·제한 완벽 가이드를 보세요.
수수료를 읽을 때 사람들이 실수로 더하는 세 장의 청구서를 나누는 편이 낫습니다. 첫째는 프로바이더 정가로, OpenRouter가 그대로 통과시킨다고 말하는 부분입니다. 둘째는 크레딧 구매에 붙는 플랫폼 비율로, 위 BYOK 한도 안에서만 0입니다. 셋째는 항상 도달 가능해야 하는 컴퓨터입니다. 전기와 옷장 서버, 또는 이미 내는 원격 Mac. OmniRoute는 둘째 청구서를 없애고 첫째·셋째는 남깁니다. OpenRouter는 셋째 대부분을 없애다가, Xcode·서명·에이전트가 고칠 저장소용 별도 머신이 또 필요해질 수 있습니다. 게이트웨이를 사도 그 머신은 사라지지 않습니다.
고르는 법: 무료 한도가 어느 장부에 잡히는지부터
1인 프로토타입이면 OmniRoute를 고르고, 직접 가입한 상위를 최소 세 곳 연결한 뒤 auto/cheap 또는 auto/offline을 쓰세요. 프로젝트 설정 노트는 무료 프로바이더 하나, 저지연 하나, 품질 높은 유료·체험 계정 하나를 권합니다. 소프트웨어만 설치하고 연결을 안 하면 첫 채팅이 실패할 수 있습니다. 무료 한도 가이드는 이를 깨진 설치가 아니라 예상 동작으로 봅니다.
팀이 한 링크로 모델을 맛보려면 OpenRouter Free를 고르고 하루 50회, 자동 라우팅 없음, 예산 스위치 없음을 받아들이세요. 그 플랜은 연기 테스트용입니다. 밤 배치용으로는 부족합니다. 호스트가 모델을 고르고 예산을 걸어야 하면 Standard로 가거나, BYOK 한도 안에서 쓰세요.
요청이 고객 데이터에 닿으면 무료 플랜에서 결론을 멈추지 마세요. OpenRouter Free 열에는 데이터 정책 라우팅이 없고, in-region routing은 Business 기능입니다. OmniRoute는 당신이 제어하는 호스트에 payload를 둘 수 있고, 그때는 그 호스트의 리전, 로그인 가능한 사람, 로그 보존 일수가 당신 질문이 됩니다. 두 경로 모두 모델 이름보다 먼저 데이터가 어디에 머무는지 문서로 써야 합니다.
도구 선택처럼 보이지만 실은 일정 선택인 네 번째 경우가 있습니다. 해커톤 주말은 OpenRouter Free로도 됩니다. 하루 50회면 프롬프트 증명은 되고, 월요일까지 데모가 살아 있을 거라고 기대하지 않습니다. PR을 올리는 에이전트를 고객에게 청구하는 계약자는 같은 상한을 쓸 수 없습니다. 오후 재시도만으로도 한도가 닳습니다. 플랜 이름 옆에 날짜를 적으세요. 날짜 없는 「Free」는 플랜이 아닙니다.
| 도구 | 입구 | 실행 | 컨텍스트 | 맞는 사람 |
|---|---|---|---|---|
| 1인 저녁 프로토타입 | 자체 호스팅 OmniRoute | 한 무료 한도가 비면 다음에 붙인 연결 시도 | 로그는 내 디스크 | 프로세스를 볼 의향이 있는 사람 |
| 공유 링크로 한번 맛보기 | OpenRouter Free | 하루 50회, 자동 라우팅 없음 | 사용량은 activity 페이지 | 아직 프로바이더를 못 고른 그룹 |
| 고객 대면 트래픽 | OpenRouter Standard 또는 BYOK, 또는 유료 키만 앞에 둔 OmniRoute | 폴백, 예산, 온콜 담당 | 리전·보존은 계약에 명시 | HTTP 429를 기능으로 볼 수 없는 팀 |
| 밤새 도는 코딩 에이전트 | 잠들지 않는 머신의 게이트웨이, 클라이언트는 base URL 하나 | 주 경로는 지정 모델, auto나 유료 자동 라우팅은 실패 후에만 |
저장소·키를 노트북 게이트웨이 로그와 섞지 않음 | 원격 Mac이나 CI 노드를 이미 가진 사람 |
이해하기 쉬운 스택
스택 1, 1인·월 낮은 고정비: OmniRoute, 실제로 연 계정 세 곳, 모델 id auto/cheap. 노트북 덮개 닫기 전에 프로세스를 항상 켜 두는 Mac으로 옮기고 base URL을 그 호스트로 바꾸세요. localhost를 계속 쓰지 마세요. 코딩 작업은 auto/coding으로. 싼 경로가 곧 품질 경로는 아닙니다.
스택 2, 팀에 키 하나: OpenRouter Standard, 모든 클라이언트가 그 base URL. Free는 신입 연기 테스트 계정용으로만. 프로덕션 키에는 budgets를 켜세요. 상위 키가 자체 프로바이더 계정에 남아야 하면 BYOK를 쓰고, 플랫폼 수수료 0은 월 정가 추론 $25,000까지라는 점을 기억하세요.
스택 3, 저장소를 고치는 에이전트: 게이트웨이는 모델 문만 해결합니다. 실행은 별도 macOS 노드에 두고 OpenClaw 클라우드 자동화 같은 것을 돌려, 에이전트와 게이트웨이가 한 대의 인터랙티브 PC에서 잠자기·포트를 다투지 않게 하세요. 모델 라우팅과 CI 노드는 두 겹입니다. 「AI 서버」 한 줄로 사지 마세요.
스택 4는 팀이 실수로 만드는 조합입니다. 노트북 OmniRoute, 같은 클라이언트에 비밀 OpenRouter 폴백, 스크립트에 하드코딩된 세 번째 키. 아래 일곱 단계에서 그 스택을 지우세요. 자동 라우터 두 개가 서로를 폴백하면 안정성이 아니라, 로그에 서로 다른 model id가 두 번 남는 실패가 됩니다. 어떤 정책이 이겼는지 말할 사람이 없습니다.
첫 데모를 넘어 살아 남는 실수
- 대시보드 프로바이더 수를 내 할당으로 읽기. OmniRoute 비교 페이지는 큰 프로바이더 숫자를 적습니다. 그건 프로젝트 카탈로그 주장입니다. 같은 시기 무료 한도 가이드는 통합 예산을 발급하지 않고, 붙이지 않은 연결은 응답하지 않는다고 말합니다.
- OpenRouter Free가 「가장 싼 모델 고르기」라고 가정. Free 열의 자동 라우팅은 No입니다.
openrouter/free는 무료 모델만 고르고, 여전히 하루 50회(또는 최소 10 credits 구매 후 1,000회) 안에 있습니다. - 프로덕션 전부를
auto로. 자동 라우팅은 폴백·탐색용입니다. 고객에게 파는 경로는 model id를 고정하고, 그 id가 실패한 뒤에만 자동 정책을 허용하세요. - 잠드는 노트북에 게이트웨이를 두고 자정 끊김을 에이전트 탓하기. 문 프로세스와 실행 머신 모두 재시작 정책이 필요합니다. 덮개 닫힘은 장애입니다.
- 플랫폼 수수료와 통과 정가를 한 숫자로 더하기. OpenRouter는 프로바이더 정가를 통과시키고 크레딧 구매에 플랫폼 수수료를 붙입니다. 자체 호스팅은 그 수수료를 없애고 당신 온콜 시간으로 바꿉니다.
표준화 전 일곱 단계
- 한 문장으로 적기: 상위 키 소유자, 프롬프트가 머무는 머신 또는 벤더 리전. 못 쓰면 제품 고르기엔 이릅니다.
- 클라이언트는 하나만. Cursor, 스크립트, Claude Code에서 두 번째 base URL을 제거해 라우터가 겹치지 않게 하세요.
- OmniRoute에는 카탈로그 스크린샷이 아니라 실제 보유 계정을 최소 세 곳 연결. OpenRouter는 계정이 아직 Free인지 credits가 있는지 확인.
- 같은 짧은 프롬프트를 두 번: 지정 모델 한 번,
auto/cheap또는openrouter/free한 번. model id, 상태 코드, 지연을 기록. - 첫 프로바이더를 끄거나 소진해 다음이 응답하는지 확인. 클라이언트가 unknown model만 내지 않는지.
- 7일간 기록: 요청 수, HTTP 429, 로그를 누가보낼 수 있는지, 주말 배치가 무료 할당을 비우는지.
- 6단계 피크가 받아들일 만할 때만 팀 기본 경로로 만들고, 그때 프로세스를 잠들지 않는 머신에 두세요.
# OmniRoute: 당신 머신 base_url = http://<your-host>:20128/v1 model = auto/cheap # OpenRouter: 호스팅 문, 연기 테스트는 openrouter/free model = openrouter/free
설정 옆에 메모를 남기세요. 소유자 없는 base URL은 한 달 안에 팀 비밀이 되고, 다음 사람이 「데모용」 세 번째 엔드포인트를 추가합니다. 일곱 단계는 1단계 문장이 7일째에도 여전히 참일 때 끝납니다.
FAQ
OmniRoute와 OpenRouter는 같은 종류의 제품인가요?
클라이언트 프로토콜은 비슷합니다. 사는 것은 다릅니다. 하나는 직접 돌리는 MIT 게이트웨이, 다른 하나는 호스팅 카탈로그입니다. 「모델 수」 한 열에 넣으면 운영과 데이터가 어디에 머무는지가 숨겨집니다.
무료 한도는 어느 계정에 잡히나요?
OmniRoute는 연결한 각 상위에 한도를 씁니다. OpenRouter Free는 OpenRouter 계정에: 하루 50회, 최소 10 credits 구매 후 무료 모델은 하루 1,000회. 어느 쪽도 무제한 풀이 아닙니다.
둘 다 쓸 수 있나요?
예, 주 경로는 하나만. 흔한 분리는 프로덕션은 OpenRouter 유료나 자체 유료 키, OmniRoute는 내부 실험만. 두 자동 라우터가 서로 폴백하지 않게 하세요. 한 번 실패가 unknown model id 두 개가 됩니다.
코딩 에이전트는 base URL만 바꾸면 되나요?
아닙니다. 게이트웨이는 저장소를 보관하지 않고 머신을 깨어 있게 하지 않습니다. 진짜 Mac이 필요하면 잠들 개발 노트북이 아니라 원격 Mac에 작업을 두세요.
카탈로그가 길면 월 비용이 싸지나요?
아닙니다. 긴 목록은 타이핑할 이름이 늘어납니다. 하루 50회 무료 상한, 5.5% 충전 수수료, 연결 없는 OmniRoute 설치에 라우트할 대상이 없다는 사실은 바뀌지 않습니다. 비용은 첫 절에서 고른 장부를, 일주일 로그로 잰 값이 따릅니다. 마케팅 표 높이가 아닙니다.
선택을 어떻게 쓸지
게이트웨이 구독 0이고 프로세스·상위 약관을 볼 의향이 있으면 OmniRoute를 고르고, 무료 한도는 카탈로그 합이 아니라 「연결한 계정」으로 이해하세요. 키 하나, 호스팅 가동 시간, 스프레드시트에 넣을 플랫폼 수수료를 원하면 OpenRouter를 고르고, 무료 플랜에는 자동 라우팅이 없다는 점을 기억하세요. 프로덕션 경로에는 model id를 고정하고, 자동 정책은 실패 경우에만. 밤새 일을 맡기기 전에 문 프로세스를 잠들지 않는 머신에 두세요.
게이트웨이와 실행 머신은 따로 사는 결정입니다. Mac mini 가격을 볼 때 상시 게이트웨이와 빌드 노드를 같은 섀시라도 두 가지 역할로 세세요. 모델 구독이 머신을 대체하지 않습니다. 주문 전 헬프 센터에서 원격 데스크톱·SSH 메모를 훑고, Mac mini 대여가 이 게이트웨이 프로세스만 깨어 있게 하려는지 결정하세요.
깨어 있는 원격 Mac에 게이트웨이를 두세요
로컬 OmniRoute는 노트북이 잠들면 같이 잠듭니다. 항상 켜진 Mac이 이 OpenAI 호환 문을 맡고, 저장소와 서명 작업은 분리할 수 있습니다.
base URL을 가리키기 전에 리전과 가격을 확인하세요. 대여 가능한 노드 보기