OpenRouter Auto Router와 Auto Code: 설정과 비용

OpenRouter는 2026년 11월 6일 발표 이후에도 openrouter/auto 모델 ID를 유지합니다. 같은 발표에서 openrouter/auto-code가 추가됐습니다. 같은 엔진 위에서 도는 코딩용 정책입니다. 둘 다 선택한 모델의 표준 요금으로 청구되며, 모델 선택은 그 요금에 포함됩니다.

섞인 트래픽, 앱, 범용 에이전트에는 범용 모델 ID를 씁니다. 코딩 도구와 코딩 에이전트에는 코딩용 모델 ID를 쓰고, 기본값으로 정하기 전에 직접 맡은 작업에서 평가합니다.

Auto Code의 모델 페이지를 2026년 11월 6일에 확인하면 출시일은 2026년 11월 5일이고, 발표보다 하루 앞섭니다. 자료는 OpenRouter의 발표와 문서이며 모두 2026년 11월 6일에 확인했습니다. OpenRouter의 유료 테스트는 실행하지 않았습니다.

Auto Router와 Auto Code 한눈에 보기

두 모델 ID는 엔진, 허용 목록과 제외 목록을 다루는 플러그인, 청구 규칙을 공유합니다. 공용 플러그인은 auto-router이고, 둘 다 여기서 allowed_models와 excluded_models를 읽습니다.

Auto Code 모델 페이지에는 EU 리전 내 옵션으로는 사용할 수 없다고 적혀 있고, OpenRouter Auto Router 가이드에는 라우터가 글로벌 데이터 리전에서만 동작한다고 적혀 있습니다(둘 다 2026년 11월 6일 확인).

코딩 에이전트에서는 무엇이 달라지나

Auto Code는 같은 엔진에 올라간 두 번째 모델 ID이고, 코드에 맞춰 조정한 정책을 씁니다. OpenRouter에 따르면 더 강한 코딩 모델을 포함한 높은 비용 등급에서 시작하고, 속도를 더 비중 있게 보며, 실패에 더 무겁게 페널티를 줍니다(OpenRouter Auto Code 가이드, 2026년 11월 6일 확인).

정책은 측정된 통과율, 속도, 해결한 작업당 비용에 더해 실시간 가격과 캐시 상태를 봅니다. 범용 Auto Router는 빠른 판단 모델로 요청마다 한 번의 호출로 점수를 매긴 뒤 모델과 추론 강도를 고릅니다(OpenRouter Auto Router 가이드, 2026년 11월 6일 확인).

에이전트 세션에서 작업이 잘 풀리는 동안 Auto Code는 현재 모델을 유지합니다. 전환하기 전에 추론 강도를 먼저 올리고, 테스트가 실패하거나 같은 오류가 반복되면 더 빨리 전환합니다. OpenRouter는 새 모델이 캐시를 다시 만드는 동안 전환에 추가 비용이 들 수 있다고 설명합니다. 그래서 이 동작은 세션의 많은 부분을 이미 데워진 모델 위에 붙잡아 둡니다.

고정 코딩 모델을 비교한다면 코딩 에이전트 모델 비교에서 저장소 작업으로 평가하는 방법을 다룹니다.

API 설정: 모델과 맞는 플러그인 ID

model 파라미터에 원하는 모델 ID를 넣고, 그에 맞는 플러그인 항목을 보냅니다. Auto와 Auto Code는 모두 auto-router 플러그인에서 allowed_models와 excluded_models를 읽습니다.

다음 cURL 요청은 범용 모델 ID를 낮은 비용 등급으로 보냅니다.

curl https://openrouter.ai/api/v1/responses \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/auto",
    "input": "Explain when prompt caching helps",
    "plugins": [
      { "id": "auto-router", "cost_tier": "low" }
    ]
  }'

낮은 등급은 추정 비용이 낮은 쪽을, 중간은 비용과 성능의 균형을, 높은 등급은 비용을 정당화할 만한 이득이 있을 때 더 강한 모델을 택합니다. 문자열 xhigh와 max도 계속 쓸 수 있고 높은 등급처럼 동작합니다(Auto Router 가이드, 2026년 11월 6일 확인).

Auto Code의 요청 본문은 cURL 껍데기를 뺀 형태이며, Chat Completions를 쓰고 허용 목록을 같은 플러그인 ID에 둡니다.

{
  "model": "openrouter/auto-code",
  "messages": [
    { "role": "user", "content": "Add a retry with backoff to fetchUser in api/users.ts" }
  ],
  "plugins": [
    {
      "id": "auto-router",
      "allowed_models": ["anthropic/*", "openai/*"],
      "excluded_models": ["~anthropic/claude-opus-latest"]
    }
  ]
}

패턴은 와일드카드로 맞추고 대소문자를 구분합니다. 제외한 모델은 허용 패턴에 맞아도 건너뜁니다. 제한 때문에 고를 수 있는 집합이 비면 요청은 HTTP 404를 돌려줍니다.

Auto Code에서 범용 등급을 쓰려면 Auto Code 가이드는 별도 jev-router 플러그인 항목을 씁니다.

{
  "id": "jev-router",
  "cost_tier": "medium"
}

설정이 두 개 더 있습니다. provider.max_price는 라우터가 모델을 고른 뒤 엔드포인트를 걸러 내고, 모델 선택은 라우터 쪽에 남습니다. 본문에 session_id를 최대 256자까지 넣거나 헤더로 x-session-id를 보냅니다. 둘 다 있으면 본문 값이 이깁니다.

클라이언트가 자동 선택 모델 ID 대신 고정 모델 ID를 기대한다면 Cline 사용자 지정 API 키 설정에 넣는 위치가 나옵니다.

요청마다 드는 비용

모델 선택은 청구서에 아무것도 더하지 않습니다. 선택한 모델의 표준 요금을 내고 선택 수수료는 0입니다(Auto Router와 Auto Code 가이드, 2026년 11월 6일 확인). Auto Code도 고른 모델로 요금이 정해집니다.

기본 범용 정책은 작업당 비용이 이전 Auto Router보다 높을 수 있습니다. OpenRouter 가이드는 이전 동작에 가깝게 쓰려면 cost_tier: low를 권합니다(2026년 11월 6일 확인).

BYOK 요청은 OpenRouter의 별도 청구 정책을 따릅니다. 공급자 키를 두 라우터 중 하나와 함께 쓰기 전에 BYOK 문서를 확인하십시오(2026년 11월 6일 확인). 라우터의 선택 수수료는 0입니다.

캐시, 모델 전환, 응답 메타데이터

세션 중간에 모델을 바꾸면 새 모델이 입력 토큰 캐시를 다시 만드는 동안 추가 비용이 듭니다(발표, 2026년 11월 6일 확인). 문서에 따르면 추론 강도를 바꾸는 것으로 충분할 때 라우터는 그쪽을 먼저 택합니다.

세션은 가능한 범위에서 같은 모델로 유지되며, 요청 없이 60분이 지나면 만료됩니다(프롬프트 캐시 가이드). 성공한 요청은 타이머를 다시 시작합니다.

청구 귀속을 확인하려면 응답의 model 필드를 기록합니다. 실제로 요청을 처리한 모델 이름이 들어 있습니다. openrouter_metadata 안에서 최상위 requested 멤버는 요청한 모델을 보여 주며, 둘은 다를 수 있습니다. is_byok는 내 공급자 키를 썼는지 알려 줍니다.

라우터 메타데이터는 직접 켜야 합니다. X-OpenRouter-Metadata: enabled를 보냅니다(메타데이터 스키마). 캐시 적중 시에는 openrouter_metadata가 빠지므로, 캐시로 다시 실행하면 처리한 모델은 보이지만 처음 선택의 세부 정보는 빠집니다. 응답에는 cache_discount와 cached_tokens도 실리며, 캐시 적중은 가능한 범위에서만 이뤄집니다.

OpenRouter의 벤치마크 주장 읽는 법

OpenRouter의 발표는 공급업체 벤치마크 비교를 보고합니다. Auto Code는 다섯 개 벤치마크에서 Claude Opus 5.5와 비슷한 점수를 내고 작업당 비용은 74% 낮다는 내용입니다(OpenRouter, 2026년 11월 6일). 비교 대상은 Auto Code와 Opus 5.5이고, 범용 Auto Router는 다른 모델 ID입니다. OpenRouter가 낸 작업당 벤치마크 주장이므로 예산을 잡기 전에 직접 맡은 작업에서 비교하십시오.

자동 선택과 고정 모델 중 무엇을 고를까

요청 유형이 다양하고 앱, 채팅 제품, 범용 에이전트에서 모델 ID 하나를 쓰고 싶다면 범용 Auto Router를 씁니다. 코딩 도구나 코딩 에이전트에는 Auto Code를 씁니다. 그 정책이 겨냥한 작업이기 때문입니다. 기본값으로 정하기 전에 직접 맡은 작업에서 평가하십시오.

내 작업에 맞는 모델을 이미 안다면 고정 모델을 고릅니다. OpenRouter 발표도 그렇게 권합니다. 고정 ID는 비용, 캐시, 동작을 릴리스 사이에 비교하기도 쉽게 합니다. 자동 선택과 고정 모델의 맞바꿈은 OpenRouter 대안 비교에서 다룹니다.

OmniaKey 모델 카탈로그에는 키 하나로 쓸 수 있는 고정 모델이 정리되어 있습니다.

에이전트에는 리더보드가 아니라 내 저장소 작업으로 고정 모델을 평가하십시오.

자주 묻는 질문

Auto Code는 Auto Router와 다른 모델인가요?

아니요. Auto Router와 같은 엔진에 있는 두 번째 모델 ID이고, 코딩 작업에 맞게 정책만 다릅니다. 별도의 독립 모델이 아니라 허용한 모델에서 고릅니다. 모델 ID는 openrouter/auto-code입니다.

Auto Code는 auto-router 플러그인의 cost_tier를 따르나요?

아니요. 거기 있는 cost_tier를 무시하고 자체 코딩 등급으로 동작합니다. 범용 낮음, 중간, 높음을 요청하려면 별도 jev-router 플러그인 항목에 cost_tier를 설정합니다.

요청당 비용은 어느 쪽이 더 싼가요?

둘 다 처리한 모델의 표준 요금으로 청구되고 선택 수수료는 0입니다. 싼지는 각자가 내 작업에서 고르는 모델에 달려 있으니 직접 맡은 작업에서 비교하십시오.

실제로 응답한 모델은 어떻게 보나요?

응답의 model 필드를 보십시오. 처리한 모델 이름이 들어 있습니다. 요청별 세부 정보는 메타데이터 헤더로 직접 켜면 볼 수 있습니다.

Auto Code를 특정 모델로 제한할 수 있나요?

예. allowed_models와 excluded_models를 auto-router 플러그인에 둡니다. 대소문자를 구분해 맞추고 제외가 우선입니다. 목록 때문에 고를 수 있는 집합이 비면 HTTP 404를 돌려줍니다.

확인한 출처

• OpenRouter: 새 Auto Router와 Auto Code 발표 (2026년 11월 6일)
• OpenRouter Auto Router 가이드
• OpenRouter Auto Code 가이드
• OpenRouter: Auto Code 모델 페이지
• OpenRouter: 라우터 메타데이터
• OpenRouter: 프롬프트 캐시와 고정 세션
• OpenRouter: BYOK 요금

모두 2026년 11월 6일에 확인했습니다.

업데이트 기록

• 2026년 11월 6일 자료 스냅숏: 같은 날 OpenRouter 발표와 문서를 확인했습니다. Auto Code 모델 페이지의 출시일은 2026년 11월 5일이고, 발표의 서명 날짜는 2026년 11월 6일입니다.
• OpenRouter가 변경 기록이나 라우터 문서를 갱신하면 플러그인 ID, 비용 등급, Auto Code 정책을 다시 확인하십시오.