OpenRouter API 키 가이드

OpenRouter API 키 발급 방법과 무료 모델 사용법

OpenRouter API 키를 발급받는 방법, 무료 모델 한도, 401·402·429 오류 해결법, iPhone·Android·웹에서 OpenRouter를 쓰는 방법을 정리했습니다.

수정일
  • OpenRouter API 키(API key)는 openrouter.ai에 로그인해 openrouter.ai/keys에서 만들며, "sk-or-v1-"로 시작합니다. 키 발급은 무료이고, ID가 ":free"로 끝나는 모델은 하루 한도 안에서 무료로 쓸 수 있으며, 그 밖의 모델은 선불 크레딧으로 결제합니다.
  • OpenRouter는 여러 AI 회사의 모델을 계정 하나, 키 하나로 쓰게 해 주는 서비스입니다. iPhone이나 Android용 자체 채팅 앱은 내놓지 않았으므로, 휴대폰에서는 Oriveo처럼 OpenRouter 키를 받는 채팅 앱을 씁니다.
  • 2026년 11월 18일 기준 무료 모델은 분당 20회, 하루 50회까지 요청할 수 있고, 누적 10크레딧 이상 구매했다면 하루 1,000회까지 늘어납니다. 402 오류는 크레딧이 바닥났다는 뜻입니다.
iPhone용 Oriveo의 제공업체 화면. 연결한 제공업체와 이번 달 지출이 표시됩니다.

OpenRouter와 API 키는 무엇인가요?

OpenRouter는 여러 AI 회사의 모델을 계정 하나로 쓸 수 있게 해 주는 서비스입니다. 회사마다 따로 가입하는 대신 OpenRouter에 크레딧을 한 번 충전하고 목록에서 모델을 고르면 됩니다.

API 키(API key)는 앱이 내 계정으로 요청을 보낼 때 쓰는 비밀 코드입니다. OpenRouter는 키를 확인하고, 내가 고른 모델에 메시지를 전달한 뒤, 비용을 OpenRouter 크레딧에서 차감합니다.

OpenRouter는 앱과 개발자를 위한 서비스입니다. iPhone이나 Android용 자체 채팅 앱을 내놓지 않았기 때문에 "OpenRouter 앱"을 찾는 사람이 많습니다. 실제로 필요한 것은 OpenRouter 키를 받는 채팅 앱입니다.

OpenRouter API 키는 어떻게 발급받나요?

OpenRouter 웹사이트에서 몇 분이면 끝납니다.

  • openrouter.ai에 접속해 계정을 만들거나 로그인합니다.
  • 키 페이지(openrouter.ai/keys)를 열고 새 키를 만듭니다. 이름은 키를 쓸 앱이나 기기로 붙입니다.
  • 키를 복사합니다. OpenRouter 키는 "sk-or-v1-"로 시작하고 길이가 73자이므로, 끝까지 다 복사됐는지 확인하세요.
  • 무료가 아닌 모델을 쓰려면 Credits 페이지에서 크레딧을 충전합니다.
  • 키는 비밀번호 관리자 같은 안전한 곳에 보관합니다. 유출되면 키 페이지에서 삭제하고 새로 만드세요.

OpenRouter API는 무료인가요?

일부만 무료입니다. 계정과 키를 만드는 데는 돈이 들지 않고, OpenRouter는 ID가 ":free"로 끝나는 무료 모델을 제공합니다. 그 밖의 모델은 선불 크레딧으로 결제합니다. OpenRouter는 신규 사용자에게 소액의 무료 크레딧을 준다고도 밝히지만, 금액은 공개하지 않습니다.

무료 모델에는 한도가 있습니다. 2026년 11월 18일 기준 OpenRouter가 공개한 한도는 다음과 같습니다.

  • 잔액이 0 아래로 내려가면 무료 모델도 오류를 낼 수 있다고 OpenRouter는 안내합니다.
  • 현재 어떤 모델에 ":free" 버전이 있는지는 OpenRouter 사이트에 나와 있습니다. 무료 모델을 믿고 쓰기 전에 먼저 확인하세요.
OpenRouter API는 무료인가요?
내 계정무료 모델 분당 요청 수무료 모델 하루 요청 수
누적 구매 10크레딧 미만2050
누적 구매 10크레딧 이상201,000

OpenRouter 크레딧은 어떻게 작동하나요?

OpenRouter는 선불제입니다. Credits 페이지에서 카드나 그곳에 안내된 다른 결제 수단으로 크레딧을 사면, 요청할 때마다 크레딧이 차감됩니다. 2026년 11월 18일 기준 OpenRouter 약관에는 1회 구매 최소 금액이 $5이고, 결제 수수료가 붙으며, 사용하지 않은 크레딧은 구매 후 365일이 지나면 만료될 수 있다고 나와 있습니다. 최신 내용은 openrouter.ai/terms에서 확인하세요.

모델마다 토큰당 가격이 따로 있으며 OpenRouter의 각 모델 페이지에 나와 있습니다. 가격은 바뀌므로 여기에 옮겨 적지 않습니다. Oriveo는 답변마다 예상 비용을 보여 주고, 최종 기록은 OpenRouter의 활동(Activity) 및 결제 페이지입니다.

iPhone, Android, 웹에서 OpenRouter를 쓰려면?

공식 OpenRouter 모바일 앱이 없으므로 클라이언트 앱을 골라야 합니다. Oriveo에는 OpenRouter가 기본 탑재된 제공업체 15곳 중 하나로 애그리게이터 항목에 들어 있어서, 주소를 입력할 필요가 없습니다.

  • 제공업체를 엽니다. iPhone과 Android에서는 탭, 웹에서는 사이드바에 있습니다.
  • + 버튼(제공업체 추가)을 누르고 OpenRouter를 고릅니다. 애그리게이터 칩을 누르면 목록이 좁혀집니다.
  • "OpenRouter 연결" 아래에 키를 붙여 넣고 계속을 누릅니다.
  • "연결 확인 및 모델 동기화 중..."(Android: "연결을 확인하고 모델을 동기화하는 중…")이 표시되는 동안 Oriveo가 OpenRouter 모델 목록을 불러옵니다.
  • 모델을 골라 대화를 시작합니다. 크레딧이 없다면 ID가 ":free"로 끝나는 모델을 고르세요.
메시지 입력창과 그 아래 선택된 모델, 비용이 표시된 오늘의 대화 목록이 보이는 Oriveo 홈 화면
키를 연결한 뒤 메시지 입력창 아래에서 모델을 고릅니다. 목록의 각 대화에는 예상 비용이 표시됩니다.

OpenRouter 키는 어디에 보관되나요?

iPhone과 Android에서는 요청이 기기에서 제공업체로 바로 가고, 키는 휴대폰의 보안 저장소(iPhone은 키체인, Android는 Keystore)에 보관됩니다. 웹 앱에서는 요청이 Oriveo 서버의 실시간 중계를 거칩니다. 키는 그 요청에만 쓰이고 계정 기록으로 저장되지 않으며, BYOK 대화는 채팅 로그로 저장되지 않습니다. 키는 클라우드 동기화로 업로드되지 않습니다. 다른 기기에서 OpenRouter를 쓰려면 그 기기에도 키를 붙여 넣거나 별도 키를 만드세요.

요금은 OpenRouter 가격 그대로 OpenRouter에 직접 냅니다. Oriveo는 수수료를 붙이지 않습니다.

OpenRouter API 키가 작동하지 않는 이유는?

OpenRouter 오류 페이지(openrouter.ai/docs/api-reference/errors)에 코드별 의미가 정리되어 있습니다. 2026년 11월 18일 기준 자주 보는 오류는 다음과 같습니다.

  • Oriveo에서 402는 "제공업체 할당량 소진"으로, 429는 웹에서 "속도 제한", iPhone과 Android에서 "제공업체 요청 제한"으로 표시됩니다.
  • 목록에 모델이 보이지 않으면 모델 목록을 다시 동기화하고, OpenRouter가 아직 그 모델을 제공하는지 확인하세요.
OpenRouter API 키가 작동하지 않는 이유는?
오류의미해결 방법
401 Invalid credentials키가 잘못되었거나 비활성화 또는 삭제되었습니다전체 키를 다시 복사하거나 새 키를 만듭니다
401 "this is not an OpenRouter API key"다른 제공업체의 키를 붙여 넣었습니다openrouter.ai/keys에서 받은 키를 씁니다. sk-or-v1-로 시작합니다
402 insufficient credits계정이나 이 키의 크레딧이 바닥났습니다크레딧을 충전하거나 키 한도를 올립니다. 기다려도 해결되지 않습니다
403 Forbidden권한, 모더레이션, 가드레일, 예산 한도 중 하나에 막혔습니다키 설정과 한도를 확인하거나 메시지를 바꿉니다
429 rate limitedOpenRouter나 모델 제공업체 쪽 기준으로 요청이 너무 많습니다기다렸다가 다시 시도합니다. 무료 모델이라면 위 한도를 확인합니다
502 또는 503모델이나 그 제공업체를 지금 쓸 수 없습니다나중에 다시 시도하거나 다른 모델을 고릅니다

OpenRouter와 제공업체별 키, 무엇을 쓸까요?

모델 여러 개를 키 하나, 잔액 하나로 쓰고 싶다면 OpenRouter가 편리합니다. 해당 제공업체 자체의 계정과 결제를 원한다면 OpenAI나 Anthropic 같은 제공업체에서 직접 받은 키가 맞습니다. Oriveo는 둘 다 지원하므로 OpenRouter와 직접 키를 함께 두고, 같은 대화 안에서 모델을 차례로 바꿔 쓸 수 있습니다.

앱 이용 중 자주 묻는 질문

OpenRouter는 무료로 쓸 수 있나요?
일부는 무료입니다. 키는 무료이고, ID가 ":free"로 끝나는 모델은 하루 한도 안에서 비용이 들지 않습니다. 2026년 11월 18일 기준 하루 50회이며, 누적 10크레딧 이상 구매했다면 1,000회입니다. 다른 모델은 선불 크레딧이 필요합니다.
OpenRouter API 키는 어디서 발급받나요?
로그인한 뒤 openrouter.ai/keys에서 발급받습니다. 키를 만들고 이름을 붙인 다음 전체를 복사하세요. 키는 "sk-or-v1-"로 시작합니다.
iPhone이나 Android용 OpenRouter 앱이 있나요?
OpenRouter는 자체 모바일 채팅 앱을 내놓지 않았습니다. OpenRouter 키를 받는 채팅 앱을 쓰세요. Oriveo에서는 제공업체를 열고 +를 누른 뒤 OpenRouter를 고르고, 키를 붙여 넣고 계속을 누르면 됩니다.
OpenRouter 402 오류는 무슨 뜻인가요?
계정이나 사용 중인 키에 크레딧이 부족하다는 뜻입니다. OpenRouter에서 크레딧을 충전하거나, 키에 한도를 정해 두었다면 한도를 올린 뒤 다시 시도하세요. 저절로 풀리지 않습니다.
OpenRouter API 키가 작동하지 않는 이유는 무엇인가요?
오류 번호를 확인하세요. 401은 키가 잘못되었거나 OpenRouter 키가 아니라는 뜻, 402는 크레딧 부족, 429는 요청이 너무 많거나 무료 모델 한도에 걸렸다는 뜻입니다. 코드별 자세한 내용은 API 키 오류 가이드에 정리해 두었습니다.
OpenRouter API 키는 어떻게 생겼나요?
"sk-or-v1-" 뒤에 영문자와 숫자 64자가 이어져 모두 73자입니다. 이보다 짧다면 일부가 복사되지 않은 것입니다.

함께 읽기

블로그 글

휴대폰에서 OpenRouter 키 쓰기

웹 앱을 열거나 iPhone·Android용 Oriveo를 내려받아 OpenRouter 키를 붙여 넣고, 답변마다 예상 비용을 보면서 모델을 바꿔 써 보세요.

API 키가 아직 없어도 Oriveo Free로 시작할 수 있습니다.