OpenRouter 사용법｜API 하나로 AI 모델 3개 이상 한 번에 쓰기
GPT·Claude·Gemini까지 계정 하나로 관리하는 실전 가이드
- OpenRouter는 API 키 하나로 400개 이상의 AI 모델을 호출하는 라우팅 서비스입니다.
- OpenAI SDK와 100% 호환돼 base_url 한 줄만 바꾸면 기존 코드를 그대로 씁니다.
- 크레딧 구매 시 5.5% 수수료가 붙고, 모델 자체 가격은 제공사 정가 그대로입니다.
- 무료 모델(:free)은 분당 20회, 하루 50~1,000회 요청 제한이 있습니다.
- 회원가입부터 첫 API 호출까지 5분이면 충분합니다.
ChatGPT, Claude, Gemini를 상황마다 바꿔가며 쓰고 싶은데 계정 세 개, 결제 세 개를 관리하기 번거로우셨다면 OpenRouter 사용법부터 익히는 게 가장 빠른 해결책입니다.
개발자든, 이제 막 AI API를 붙여보려는 입문자든 결국 같은 벽에 부딪힙니다. 모델마다 API 키가 다르고, 요청 형식이 다르고, 결제 수단도 따로 등록해야 하죠.
이 글에서는 OpenRouter가 정확히 무엇인지부터, 회원가입 후 첫 API 호출까지, 그리고 요금과 무료 모델을 실수 없이 쓰는 법까지 순서대로 정리합니다.
1. OpenRouter란 무엇인가
OpenRouter는 여러 AI 제공사의 모델을 하나의 API 키, 하나의 결제 시스템으로 호출할 수 있게 해주는 통합 API 게이트웨이입니다.
2026년 8월 기준 60개 이상의 제공사에서 400개가 넘는 모델을 서비스합니다. OpenAI의 GPT 계열, Anthropic의 Claude 계열, Google의 Gemini 계열은 물론 Meta의 Llama, DeepSeek, Qwen 같은 오픈소스 모델까지 한 화면에서 고를 수 있습니다.
가장 큰 특징은 제공사가 중립적인 리셀러라는 점입니다. 특정 클라우드에 종속되지 않고, 모델별 토큰 가격도 제공사 공식가 그대로 통과시킵니다.
OpenRouter는 오픈소스 모델을 실행할 때 같은 모델이라도 이를 호스팅하는 인프라 업체가 여러 곳일 수 있다는 점을 활용합니다. 기본적으로 여러 공급자 사이에 트래픽을 분산하고, 한 곳이 장애가 나면 자동으로 다른 공급자로 넘깁니다. 요청 본문에 provider 우선순위를 직접 지정할 수도 있어, 속도와 안정성 사이에서 세밀하게 조율할 수 있습니다.
비슷한 서비스로 Cloudflare AI Gateway, AWS Bedrock, Google Vertex AI가 있지만 성격이 다릅니다. AI Gateway는 자신의 키를 그대로 쓰는 프록시일 뿐이고, Bedrock·Vertex AI는 각자의 클라우드 생태계 안에서만 모델을 묶어줍니다.
정리하면, 여러 모델을 자주 바꿔가며 비교하거나 특정 모델 장애에 대비하고 싶다면 OpenRouter가 가장 손쉬운 선택지입니다.
2. OpenRouter 사용법 첫걸음 — API 키 발급
실제 OpenRouter 사용법은 생각보다 단순합니다. 회원가입부터 첫 호출까지 순서대로 따라 하면 5분 안에 끝납니다.
1. openrouter.ai에 접속해 이메일로 가입합니다. 신용카드 등록 없이 바로 가능합니다.
2. 우측 상단 프로필 아이콘을 클릭해 ‘Keys’ 페이지로 이동합니다. 여기서 새 API 키를 발급받습니다.
3. 유료 모델을 쓸 계획이라면 ‘Credits’ 메뉴에서 카드나 암호화폐로 충전합니다. 무료 모델만 쓸 거라면 이 단계는 건너뛰어도 됩니다.
4. 발급받은 키는 sk-or-... 형태입니다. 코드 안에 직접 적지 말고 환경변수로 관리하는 편이 안전합니다.
키를 프로젝트별로 나눠서 발급받으세요. ‘Keys’ 페이지에서 키마다 이름과 지출 한도를 따로 설정할 수 있어, 개발용과 운영용을 섞어 쓰다 실수로 크레딧을 소진하는 일을 막을 수 있습니다.
‘Activity’ 페이지에서는 키별 사용 내역을 시계열 그래프로 확인할 수 있습니다. 어떤 모델에 비용이 몰리는지 한눈에 파악하기 좋습니다.
3. OpenRouter 사용법 핵심 — 코드 두 줄만 바꾸기
OpenRouter의 가장 큰 강점은 OpenAI SDK와의 완전한 호환성입니다. 이미 OpenAI API 기준으로 짠 코드가 있다면 리팩토링 없이 그대로 옮길 수 있습니다.
REST API의 기본 주소는 https://openrouter.ai/api/v1이고, 채팅 완성 요청은 /chat/completions 엔드포인트로 보냅니다. 인증은 항상 Authorization 헤더에 Bearer 토큰 형태로 API 키를 담습니다.
Python이라면 아래처럼 base_url과 api_key만 바꾸면 됩니다.
model 필드에는 제공사/모델명 형태의 슬러그를 넣습니다. 같은 코드에서 model 문자열만 바꾸면 다른 회사 모델로 즉시 전환됩니다.
모델 슬러그와 가격은 수시로 바뀝니다. 코드에 모델명을 하드코딩해 두고 몇 달 방치하면 어느 순간 없어진 모델을 부르는 오류가 날 수 있습니다. 주기적으로 모델 목록 API(GET /api/v1/models)를 호출해 슬러그가 살아있는지 확인하는 습관을 들이는 게 좋습니다.
HTTP-Referer, X-Title 같은 헤더는 필수가 아니지만, 넣어두면 자신의 앱을 OpenRouter 리더보드에 노출할 수 있습니다.
4. 요금 구조 — 5.5% 수수료와 크레딧 계산법
OpenRouter는 모델 자체에 별도 마진을 붙이지 않습니다. 토큰 가격은 제공사가 공식으로 매긴 값 그대로 통과됩니다.
대신 수익은 크레딧을 충전할 때 붙는 5.5% 수수료에서 나옵니다. 예를 들어 100달러를 충전하면 5.5달러가 수수료로 빠지고 94.5달러어치 크레딧이 남습니다. 최소 수수료는 0.80달러이고, 암호화폐 결제는 5.0%로 조금 낮습니다.
자신의 제공사 API 키를 직접 연결하는 BYOK(Bring Your Own Key) 방식도 있습니다. 월 100만 요청까지는 무료이고, 이를 넘으면 정상가의 5%가 라우팅 수수료로 붙습니다.
0.80달러라는 최소 수수료 때문에 소액을 자주 충전하면 실질 부담률이 확 올라갑니다. 5달러씩 네 번 나눠 충전하면 20달러에 3.2달러(16%)가 빠지지만, 20달러를 한 번에 충전하면 1.1달러(5.5%)만 빠집니다. 충전은 가능한 한 크게, 드물게 하는 편이 유리합니다.
5. 무료 모델로 시작하기 — 요청 제한과 :free 모델
카드를 등록하지 않고도 곧바로 시작하고 싶다면 모델 슬러그 끝에 :free가 붙은 모델을 고르면 됩니다. 토큰당 비용이 완전히 0원입니다.
2026년 8월 기준 25개 이상의 무료 모델이 있고, GPT-OSS·DeepSeek·Llama·Qwen 계열 오픈소스 모델이 주를 이룹니다. 목록은 수시로 바뀌므로 특정 모델 하나에 의존해 코드를 방치하지 않는 게 좋습니다.
단, 요청 횟수 제한이 있습니다. 분당 20회는 계정 상태와 무관하게 항상 적용됩니다. 하루 요청 한도는 크레딧을 한 번이라도 10달러 이상 충전했는지에 따라 갈립니다.
한 번 10달러를 충전해 두면 잔액이 나중에 0원이 되어도 하루 1,000회 한도는 그대로 유지됩니다. 무료 모델을 진지하게 쓸 계획이라면 처음부터 소액을 한 번 충전해두는 게 여러모로 이득입니다. 잔액이 마이너스가 되면 무료 모델 호출도 402 오류로 막힐 수 있으니 잔액을 0 이상으로만 유지하면 됩니다.
테스트만 해보고 싶다면 openrouter/free라는 라우터 모델도 있습니다. 이미지 이해나 툴 호출 같은 요청 조건에 맞는 무료 모델을 자동으로 골라줍니다.
6. 자주 하는 실수와 해결법
모델 슬러그를 코드에 박아두고 몇 달 방치하는 실수가 가장 흔합니다. 슬러그가 바뀌거나 모델이 내려가면 갑자기 호출이 실패합니다. 정기적으로 모델 목록 API를 확인하는 습관이 해결책입니다.
두 번째는 키 하나로 모든 프로젝트를 돌리는 경우입니다. 지출 한도를 걸어두지 않으면 테스트 코드의 무한 루프 하나로 크레딧이 순식간에 소진될 수 있습니다. 키를 프로젝트별로 나누고 한도를 반드시 설정하세요.
세 번째는 무료 모델의 분당 20회 제한을 프로덕션에 그대로 쓰는 경우입니다. 실서비스 트래픽이라면 유료 모델로 전환하거나 크레딧을 충전해 처리량을 확보해야 합니다.
민감한 데이터를 다룬다면 요청에 provider 객체를 넣어 data_collection을 deny로 설정하거나 zdr(Zero Data Retention) 옵션을 켜세요. 데이터를 저장·학습에 쓰지 않는 제공사로만 라우팅을 제한할 수 있습니다.
❓ 자주 묻는 질문
무료 모델(:free)만 쓴다면 신용카드 없이 계속 무료로 사용할 수 있습니다. 다만 분당 20회, 하루 50~1,000회의 요청 제한이 있어 실서비스보다는 학습·테스트용에 적합합니다.
가능합니다. API 연동 없이도 사이트 내 채팅 화면에서 바로 여러 모델을 골라 대화할 수 있습니다. 다만 여러 모델을 자동화된 서비스에 붙이려면 API 사용법을 익혀야 합니다.
목적이 다릅니다. OpenRouter는 최신 대형 모델을 인터넷으로 빌려 쓰는 방식이고, 로컬 AI는 내 PC에 모델을 내려받아 오프라인으로 돌리는 방식입니다. 데이터를 외부로 보내고 싶지 않다면 로컬 AI 쪽을 함께 검토해 보세요.
공식적으로 만료 기한이나 월 구독료는 없습니다. 충전한 크레딧은 토큰을 쓸 때마다 차감되는 방식이라 쓰는 만큼만 줄어듭니다.
기본값은 저장하지 않는 쪽입니다. 프롬프트 로깅을 직접 켜지 않는 한 요청·응답 내용은 저장하지 않고, 모델 사용량 같은 메타데이터만 남습니다. 다만 실제 응답을 생성하는 하위 제공사의 정책도 함께 확인하는 게 안전합니다.
📚 함께 보면 좋은 글
OpenRouter로 여러 AI를 클라우드에서 써봤다면, 이번엔 내 PC 안에서 직접 돌리는 로컬 AI도 함께 살펴보세요.
🔗 공식 자료
📖 출처
TILNOTE, “OpenRouter 사용법 완벽 가이드”
습관적 질문자들(위키독스), “4.2 OpenRouter – 하나의 API로 여러 생성형 AI 모델 사용하기”
Porter AI 블로그, “오픈라우터(OpenRouter)를 스마트하게 활용하는 방법”
TrueFoundry 블로그, “OpenRouter Pricing 2026: Plans, Costs, and Hidden Fees”
Amnic 블로그, “OpenRouter Pricing: Fees, Credits & BYOK Explained”
OpenRouter 공식 지원센터(Zendesk), “What is the OpenRouter API base URL”
OpenRouter 사용법의 핵심은 API 키 하나로 GPT·Claude·Gemini·오픈소스 모델을 자유롭게 오가는 것입니다. 무료 모델로 먼저 감을 잡고, 요금 구조를 이해한 뒤 필요한 만큼만 크레딧을 충전하면 여러 AI를 관리하는 부담이 크게 줄어듭니다.
