목록으로 OpenRouter Auto Router

바이브코딩

OpenRouter Auto Router | 요청마다 모델을 고르는 openrouter/auto

자기 단가는 없고, 선택된 모델의 정가로 청구된다.

OpenRouter Auto Router | 요청마다 모델을 고르는 openrouter/auto

OpenRouter Auto Router는 답을 직접 만드는 모델 이름이 아니다. 요청을 읽고, 그 일을 맡을 다른 모델을 고르는 OpenRouter의 대표 라우터다. 앱, 채팅, 일반 에이전트가 모델 목록을 매번 고정하지 않아도 호출은 모델 한 칸으로 시작한다.

호출에 넣는 값은 openrouter/auto다. 2026년 8월 10일 OpenRouter는 이 라우터를 최근 7일 사용 금액 기준으로 다시 짰다고 발표했다. 추가 라우팅 요금은 없다. 돈은 실제로 답을 만든 모델의 정가다.

모델 카드가 지금 적는 공개일은 2026년 11월 5일이다. Models API의 created 값 1793885889는 협정세계시 2026-11-05 13:38:09, 한국시간 22:38:09다. 같은 슬러그를 다룬 글은 2025년 1월 1일과 2026년 8월 10일에도 있다. 11월 5일은 현재 카드의 공개일이고, 슬러그가 그날 처음 생긴 날이라는 뜻으로 읽히지는 않는다.

기준일은 2026년 11월 6일이다. 모델 페이지, Models API, Auto Router 가이드, 8월 10일 발표를 봤다. 코딩 에이전트 전용인 Auto Code(openrouter/auto-code)는 같은 엔진을 쓴다고 카드가 적지만, 일반 목적 라우터와 슬러그가 다르다.

Auto Router가 하는 일

사람이 모델 이름을 고르는 자리를 라우터가 대신한다. 사용자는 평소처럼 메시지를 보내고, OpenRouter는 그 요청을 어느 모델로 넘길지 정한다. 앱, 채팅, 일반적인 에이전트에 쓰라고 모델 페이지가 적는다.

카드의 설명은 네 가지를 같이 본다고 한다. 작업이 얼마나 어려운지, 벤치마크, 그 시점의 가격, 프롬프트 캐시다. 에이전트처럼 턴이 이어지면, 일이 잘 풀리는 동안 같은 모델을 유지하고, 막히면 추론 강도를 올리거나 모델을 바꾼다고도 적는다. 가드레일, ZDR(무보존), 예산 같은 계정 설정은 그대로 따른다.

입력은 글, 이미지, 오디오, PDF 같은 파일, 영상이다. 출력은 글과 이미지다. 카드의 모달리티 표기는 text+image+file+audio+video->text+image이고, 토크나이저 칸은 Router다. 이 칸은 라우터 자신의 어휘 목록이 아니라, 뒤로 넘기는 자리라는 뜻에 가깝다.

핵심 포인트: openrouter/auto는 가중치가 고정된 모델이 아니다. 요청마다 다른 모델이 답을 만들고, 응답의 model 칸에 그 이름이 남는다.

요금은 선택된 모델의 정가

Auto Router에는 자기 단가가 없다. 모델 페이지 FAQ는 이렇게 적는다. 고정 가격이 없고, 그 요청을 처리한 모델의 가격으로 청구된다. Models API의 pricing.prompt와 pricing.completion은 둘 다 "-1"이다. 사이트 카탈로그의 -1도 같은 값이다. 달러로 환산할 단가가 비어 있다는 표시로 읽는 것이 맞다.

가이드도 같다. Auto Router를 쓴다고 덧붙는 수수료는 없다. 상한을 두고 싶으면 provider.max_price가 그대로 동작한다. 라우터가 모델을 고른 뒤, 그 모델의 공급자 엔드포인트 가운데 상한을 넘는 곳을 거른다.

기본 비용 성향은 싼 쪽이다. 가이드는 비용 설정을 비운 요청을 대략 low 구간으로 보낸다고 적는다. 8월 10일 발표의 비교표도 새 라우터의 Default를 cost_tier=low로 둔다. 아무 설정도 없이 호출하면 가장 능력 있는 모델을 고른다는 뜻은 아니다.

컨텍스트도 라우터 숫자가 곧 보장은 아니다. 카드 FAQ는 최대 2,000,000토큰까지 창이 있는 모델로 보낼 수 있다고 한다. 그 요청에서 실제로 열리는 길이는 선택된 모델의 길이다. API의 context_length는 2000000이고, top_provider.context_length와 max_completion_tokens는 null이다. 공급자 한 곳의 출력 상한이 카드에 박혀 있지 않다.

요금은 라우터가 아니라 선택된 모델
그림 1. API 가격 칸은 -1이고, 추가 라우팅 수수료는 없다. 설정을 비우면 대략 low 구간이다.

유럽 리전 안에서의 처리도 지금 카드와 API 안내 모두 불가라고 적는다. EU in-region routing 경로에는 openrouter/auto가 올라 있지 않다.

요청이 모델로 가는 순서

가이드가 적는 순서는 네 단계다. 순위는 익명화된 지출 통계로 만들고, 프롬프트 분류는 저장을 요구하지 않은 채 요청 중에 한다.

첫째, 가벼운 분류기가 프롬프트를 약 30개의 세부 유형 중 하나로 붙인다. 문서가 예로 든 이름은 code:debugging, agent:multi_step_planning, qa_knowledge, math, customer_support, research_report다. 분류 결과를 보려면 헤더 X-OpenRouter-Metadata: enabled를 보낸다. 그러면 openrouter_metadata.pipeline의 라우터 단계 data.task_type에 태그가 있다. 분류가 안 되면 그 필드는 없다.

둘째, 그 유형에서 최근 7일 OpenRouter 이용자가 실제로 돈을 쓴 모델 순위를 본다. 랭킹 페이지의 Share of Spend와 같은 신호다. 사람들이 새 모델로 일을 옮기면, 재학습 없이 며칠 안에 라우터도 따라간다고 가이드는 적는다.

셋째, cost_tier로 가격 띠를 고른다. 띠 안의 후보는 다시 지출 점유율 순이다.

넷째, 살아남은 상위 모델이 1순위와 폴백이 된다. 계정의 모델·공급자 제한, 가드레일, ZDR, allowed_models, 출력 모달리티를 반영한 뒤의 순서다. 분류나 순위 자료를 못 구하면 기본 모델 집합으로 내려가고, 라우팅 장치 문제만으로 요청이 실패하지는 않는다고 적는다.

모델을 고르는 네 단계
그림 2. 분류, 7일 지출 점유율, 비용 띠, 폴백 순서로 후보가 좁혀진다.

8월 10일 발표는 이 신호를 주간 토큰 지출 55T 이상으로 설명했다. 55T는 그 글에 적힌 규모다.

비용 구간은 다섯 칸

구간 이름은 싼 쪽에서 능력 쪽으로 low, medium, high, xhigh, max다. low는 그 일에서 능력이 되는 싼 모델을 선호하고, max는 가격과 상관없이 능력이 큰 쪽을 선호한다. 가이드의 문장이다.

구간은 상한선이 아니다. 그 띠보다 비싼 모델만 빠지는 것이 아니다. 띠보다 싼 모델도 빠진다. medium을 고르면 가장 싼 모델이 자동으로 포함되지 않는다.

구간가이드가 적는 성향비웠을 때
low능력이 되는 선에서 싼 모델설정이 없으면 대략 여기
medium중간 가격 띠요청에 적어야 적용
high더 높은 가격 띠요청에 적어야 적용
xhigh높은 가격 띠요청에 적어야 적용
max가격보다 능력요청에 적어야 적용

요청에 넣는 플러그인 아이디는 auto-router다. 비용 구간과 허용 목록은 그 객체 안에 둔다.

{
  "model": "openrouter/auto",
  "messages": [
    { "role": "user", "content": "이 함수에서 널 참조가 나는 줄을 짚어 줘" }
  ],
  "plugins": [
    {
      "id": "auto-router",
      "cost_tier": "medium",
      "allowed_models": ["anthropic/*", "openai/*"]
    }
  ]
}

계정에 기본값을 저장할 수도 있다. 워크스페이스 Routing 페이지의 Auto Router 칸에 허용 모델, 제외 모델, 비용 선호가 있다. 저장한 제외 목록은 허용 목록보다 이긴다. 저장된 값은 openrouter/auto와 openrouter/auto-beta 둘 다에 적용된다. 같은 필드를 요청에 다시 적으면 요청이 이기고, prevent overrides를 켜면 저장된 값이 최종이다.

후보를 좁히는 패턴

허용 목록과 제외 목록은 같은 와일드카드다. 제외는 허용 다음에 적용되므로, 허용 패턴에 걸려도 제외된 모델은 선택되지 않는다.

패턴가이드 표의 의미
anthropic/*Anthropic 모델 전부
openai/gpt-5*GPT-5 계열
google/*Google 모델 전부
openai/gpt-5.1그 슬러그만
/claude-공급자와 무관하게 이름에 claude가 있는 모델

패턴을 하나도 안 주면, 그 작업 유형의 순위 후보 전체를 본다. 제한을 너무 좁혀 남는 모델이 없으면 요청은 404이고, 메시지 문구는 No models match your request and model restrictions다.

베타 슬러그 openrouter/auto-beta는 새 동작을 먼저 받는 자리다. 같은 페이지의 설정이 적용되지만, 요청 플러그인 아이디는 auto-beta-router여야 한다. auto-router로 보낸 allowed_models, excluded_models, cost_tier는 베타 요청에서 받아 두었다가 조용히 무시된다. 반대도 같다. 오류로 돌려주지 않는다는 점이 함정이다.

여러 턴에서 같은 모델을 유지하는 방식

고정 슬러그와 달리 Auto Router는 턴마다 다른 모델을 고를 수 있다. 대화가 흩어지지 않게, 한 번 고른 모델을 기억했다가 다음 턴에서 우선한다. 대화를 구분하는 키는 명시적 session_id이거나, 그게 없으면 메시지 지문이다.

매 턴 순위는 처음부터 다시 매긴다. 기억한 모델은 그 턴의 상위 후보에 아직 있을 때만 재사용된다. 일이 다른 유형으로 바뀌면 더 맞는 모델이 이길 수 있다. 어느 쪽이 답했는지는 매 응답의 model 칸이 알려 준다.

공급자 단위의 붙박이도 다른 모델과 같다. 프롬프트 캐시 문서는 스티키 세션이 비활성 10분 뒤에 끝난다고 적는다. 성공한 요청이 있으면 그 시계는 다시 출발한다. 같은 문서는 Auto Router 같은 라우터도, 후보 집합에 남아 있는 동안 해석된 모델을 최선을 다해 다시 쓴다고 적는다. 후보에서 빠지면 그 힌트는 무시된다.

8월 발표는 모델을 자주 바꾸면 입력 캐시를 다시 데우는 비용이 든다고 설명한다. 새 일에 더 맞는 모델로 가는 비용은 남을 수 있고, 이유 없이 자주 바뀌는 비용은 낭비에 가깝다고도 적는다. 붙박이는 그 낭비를 줄이려는 장치다.

Responses API에서는 session_id, SDK에서는 sessionId로 같은 대화를 표시한다. 헤더 x-session-id의 세부 규칙은 캐시 문서가 담당한다.

응답의 model 칸과 호출 위치

채팅 완성은 POST https://openrouter.ai/api/v1/chat/completions이고, Responses API는 POST https://openrouter.ai/api/v1/responses다. 모델 페이지는 OpenAI 호환이라 대부분의 SDK가 베이스 주소만 바꾸면 된다고 적는다. 인증은 Authorization: Bearer와 API 키다.

가장 짧은 호출은 모델 값만 라우터로 둔다.

{
  "model": "openrouter/auto",
  "messages": [
    { "role": "user", "content": "이 문단을 세 문장으로 줄여 줘" }
  ]
}

가이드의 응답 예시는 model이 anthropic/claude-sonnet-4.5처럼 실제 선택된 슬러그로 바뀌어 돌아온다. 그 예시는 형식이지, 오늘 모든 요청이 그 모델로 간다는 뜻이 아니다. 사용량은 Responses 예시에서 input_tokens, output_tokens, total_tokens로 돌아온다.

레거시 prompt 필드만 보내면 라우터 조건에 안 맞는다. 가이드의 제한은 대화형 입력이다. Responses의 input이거나 Chat Completions의 messages다. 스트리밍은 지원하고, 도구 호출 같은 표준 기능은 선택된 모델 쪽에서 동작한다고 적는다.

카드가 받는다고 광고하는 매개변수에는 tools, tool_choice, response_format, reasoning, reasoning_effort, temperature, max_tokens, structured_outputs 등이 있다. 광고 목록에 있다는 사실과, 뒤로 뽑힌 모델이 그 매개변수를 모두 지킨다는 사실은 같지 않다. 선택된 모델이 도구를 모르면 그 요청의 도구 동작은 그 모델의 한계를 따른다.

2026년 8월 10일 벤치마크

OpenRouter는 새 라우터를 다섯 벤치로 옛 라우터와 비교해 발표했다. MMLU Pro(지식), τ³-bench Banking(에이전트), WideSearch(검색), DSQA(조사), SWE-Atlas QnA(코딩)다. SWE-Atlas는 Scale의 공개 저장소를 출처로 링크했다.

표의 Default는 새 라우터 cost_tier=low와 옛 라우터 cost_quality_tradeoff=7이다. Max는 cost_tier=max와 옛 cost_quality_tradeoff=0이다. 발표는 이 숫자가 한 시점이며, 이용자 선호가 바뀌면 같이 움직인다고 적는다. 아래 숫자는 그 글의 표 그대로다.

벤치새 Default옛 Default새 Max옛 Max
MMLU Pro85.2% ±0.386.6% ±0.191.4% ±0.388.8% ±0.3
τ³-bench Banking20.6% ±1.021.0% ±1.031.6% ±1.67.2% ±2.7
WideSearch61.6% ±2.653.1% ±2.661.9% ±2.454.8% ±2.6
DSQA62.9% ±1.643.2% ±1.763.0% ±1.642.3% ±1.7
SWE-Atlas QnA30.4% ±2.030.4% ±2.360.7% ±1.72.4% ±0.0

지식 벤치의 기본 구간은 옛 라우터보다 1.4%포인트 낮다. 검색과 조사, 코딩 최고 구간은 새 쪽이 높다. 에이전트 벤치의 최고 구간은 7.2%에서 31.6%로 올라 있고, 기본 구간은 거의 같다.

같은 글의 비용 표는 달러다. MMLU Pro 기본은 393.34달러에서 140.93달러로 줄었고, 최고 구간은 449.61달러에서 255.71달러다. WideSearch 기본은 31.83달러와 30.75달러로 비슷하다. DSQA 기본은 147.11달러에서 276.00달러로 늘었다. SWE-Atlas QnA 기본은 463.73달러에서 297.23달러로 줄었고, 최고 구간은 205.52달러에서 1,325.08달러로 늘었다. Banking 최고 구간은 점수와 반대로 옛 쪽이 99.36달러, 새 쪽이 168.41달러다.

발표가 세운 기준은 두 줄이다. 기본 구간에서는 옛 라우터와 비슷한 성능을 더 싼 값에 내는 것이었고, 대부분 영역에서 그렇게 봤다고 한다. 옛 라우터가 당시 저가 모델보다 못하던 예외가 있었다고도 적는다. 최고 구간에서는 비용이 옛보다 올라도 프론티어 성능을 기준으로 삼았다. DSQA 기본 비용이 오른 행과 SWE-Atlas 최고 비용이 오른 행은 그 문장과 같이 읽어야 한다. 모든 칸이 더 싸고 더 높은 것은 아니다.

작업 유형과 구간이 만나는 모델 이름 격자는 2026년 8월 10일 스냅샷이라고 캡션이 적는다. 최신 순위는 랭킹 페이지에 있다. 셀 안의 모델 이름은 며칠이면 바뀐다고 같은 글이 말한다.

예전 숫자 설정과 베타 슬러그

2025년 1월 1일 발표는 Auto Router를 19개 모델로 늘리고, NotDiamond의 메타 모델을 시험한다고 적었다. 당시 문장은 API가 무료이며 나중에 바뀔 수 있다고 했다. 그 무료 문구는 현재 가이드의 요금 설명과 다르다. 지금 문서는 추가 수수료가 없고 선택된 모델 정가를 낸다고 한다.

옛 문서 일부는 아직도 Auto Router를 NotDiamond가 고른다고 적는다. 모델 라우팅 기능 문서가 그런 페이지다. 2026년 11월 6일에 열린 정본 가이드는 NotDiamond를 언급하지 않고, 7일 지출 점유율과 cost_tier를 설명한다. 같은 제품 이름의 페이지가 두 세대로 남아 있다. 구현을 볼 때는 가이드 URL docs/guides/routing/routers/auto-router를 현재 설명으로 두는 편이 맞다.

옛 요청 매개변수는 cost_quality_tradeoff다. 8월 발표는 0이 품질 쪽, 숫자가 클수록 비용 쪽이고 기본이 7이라고 적는다. 현재 가이드는 이 값을 이전 버전의 것으로 표시하고, 받기는 하지만 폐기 예정이라고 한다.

두 문서는 둘을 같이 보냈을 때의 우선순위가 반대다. 8월 10일 발표는 cost_quality_tradeoff가 우선이라고 적는다. 현재 가이드는 cost_tier가 우선이라고 적는다. 서버가 어느 문장을 따르는지 별도의 공지는 없다. 날짜가 늦은 쪽은 현재 가이드다.

Auto Code는 카드에서 코딩 에이전트와 하네스용 라우터로 소개된다. 같은 라우팅 엔진을 쓰고, 요청을 에이전트 세션의 일부로 보며, 실패한 코드 변경에 더 무게를 둔다고 페이지가 적는다. 일반 목적의 openrouter/auto와 슬러그가 다르다.

다른 라우팅과 겹치지 않는 지점

OpenRouter에는 라우터 말고 폴백 배열도 있다. models에 슬러그를 순서대로 넣으면, 앞 모델의 공급자가 죽거나 한도에 걸리거나 내용 정책으로 거절할 때 다음 모델로 간다. 그건 사용자가 순서를 적는 방식이다. Auto Router는 순서를 적지 않고 작업 유형과 지출 점유율로 순서를 만든다. 응답에 남는 model이 실제로 청구되는 모델이라는 점은 둘 다 같다.

공급자끼리의 트래픽 배분은 또 다른 층이다. 2026년 10월 28일 발표는 한 모델 안에서 어느 엔드포인트로 보낼지를 가격과 속도로 다시 짰다고 설명한다. Auto Router가 모델을 고른 뒤의 일이고, provider.sort를 price로 두면 그 층만 가격 정렬로 고정할 수 있다. 라우터의 cost_tier와 공급자 정렬은 같은 스위치가 아니다.

카드가 광고하는 입력 종류가 넓어도, 뽑힌 모델이 영상을 받지 않으면 그 요청의 영상 입력은 그 모델의 한계에 걸린다. 2,000,000토큰도 같은 구조다. 라우터가 닿을 수 있는 상한이지, 매 요청의 예약 창이 아니다.

200만 토큰은 상한, 보장은 아니다
그림 3. 컨텍스트 200만은 라우터가 닿는 상한이고, auto-beta는 플러그인 아이디가 다르다.

마무리

앞에서 다룬 OpenRouter Auto Router의 핵심만 짧게 정리한다.

  • openrouter/auto는 일반 목적 라우터이고, 모델 카드의 공개일은 2026년 11월 5일이다.
  • 추가 수수료는 없고, 청구는 선택된 모델의 정가다. API 가격 칸은 -1이다.
  • 순서는 작업 유형 분류, 최근 7일 지출 점유율, 비용 구간, 폴백이다.
  • 구간을 비우면 대략 low다. 구간은 상한이 아니라 띠라서 더 싼 모델도 빠진다.
  • 여러 턴은 session_id나 메시지 지문으로 모델을 붙잡고, 상위 후보에서 빠지면 바뀐다.
  • 베타 슬러그의 플러그인 아이디는 auto-beta-router다. 다른 아이디의 설정은 조용히 무시된다.
  • 8월 10일 벤치 숫자는 그 시점의 비교이고, 오늘 셀의 모델 이름은 랭킹이 보여 준다.

「라우터의 가격표는 없고, 영수증에는 선택된 모델의 이름이 남는다」 같은 대화를 한 모델에 붙들려면 session_id를 넣고, 비용을 띠로 고정하려면 cost_tier를 auto-router 플러그인에 둔다. 공개 단가와 벤치 셀은 2026년 11월 6일 문서 기준이며, 7일 지출 순위는 그 뒤로도 움직인다.

출처와 링크

조사 기준은 2026년 11월이다. 모델 카드와 가이드는 2026-11-06에 열었고, 벤치 숫자는 2026-08-10 발표 표 그대로다.

FAQ

자주 묻는 질문

openrouter/auto를 호출하면 따로 라우팅 요금이 붙나요?

가이드는 라우터를 썼다는 이유만으로 덧붙는 수수료는 없다고 적는다. 영수증에 남는 금액은 그 요청을 실제로 처리한 모델의 정가다. 같은 API 행의 top_provider.is_moderated는 false라, 가격 칸의 -1과 모더레이션 표시는 별개다.

카드의 200만 토큰은 매번 그 길이만큼 열린다는 뜻인가요?

카드 FAQ는 창이 200만 토큰까지인 모델로 보낼 수 있다고 설명한다. 그 호출에서 실제로 열리는 길이는 뽑힌 모델의 창이다. API의 top_provider.context_length는 null이라, 공급자 한 곳의 출력 상한이 카드에 고정돼 있지는 않다.

cost_tier를 요청에 안 적으면 어느 쪽으로 가나요?

현재 가이드는 비용 설정을 비운 요청을 대략 low 구간으로 본다고 적는다. 8월 10일 비교표의 새 Default도 cost_tier=low다. 그 표의 기본 구간 Banking 비용은 새 155.89달러, 옛 320.04달러로, 최고 구간 행과는 다른 비교다.

auto-beta에 auto-router 플러그인 설정을 넣으면 적용되나요?

베타 슬러그의 요청 플러그인 아이디는 auto-beta-router다. auto-router로 보낸 allowed_models, excluded_models, cost_tier는 베타 쪽에서 받아 두고 조용히 무시한다. 8월 10일 발표의 수천 명 베타 시험은 그 전의 시험 배포이고, 이 플러그인 아이디 규칙과 같은 문장은 아니다.

2026년 11월 5일이 이 슬러그의 첫날인가요?

지금 모델 카드의 공개일과 Models API created 1793885889는 2026년 11월 5일을 가리킨다. 같은 슬러그를 설명한 글은 2025년 1월 1일과 2026년 8월 10일에도 있다. 바이브코딩365 카탈로그의 first_seen_at은 2026-11-05T11:49:39.199Z로 created보다 이르며, 출시 시각이 아니라 목록에 잡힌 시각이다.

지금 이 프롬프트가 어느 모델로 가는지 표로 알 수 있나요?

응답의 model 칸이 그 호출에서 선택된 슬러그다. 가이드 예시에 나오는 anthropic/claude-sonnet-4.5는 형식 예시이고, 오늘 모든 요청의 목적지는 아니다. 8월 10일 표에서 DSQA 최고 구간 비용은 새 248.83달러, 옛 144.18달러인데, 그 칸도 오늘 선택되는 모델 이름을 알려 주지는 않는다.

cost_tier와 cost_quality_tradeoff를 같이 보내면 어느 쪽이 이기나요?

8월 10일 발표는 옛 숫자 설정이 우선이라고 적고, 현재 가이드는 cost_tier가 우선이라고 적는다. 두 문장의 날짜는 가이드가 더 늦다. 아직 NotDiamond라고 적는 옛 페이지는 docs/guides/features/model-routing 이다.