Vercel AI Gateway 사용자별 예산으로 팀원 지출을 제한하는 방법

폭주한 코딩 에이전트 하나 때문에 더 이상 프로덕션 앱까지 같은 비용 차단 스위치에 묶어 둘 필요가 없습니다. 2026년 8월 31일, Vercel AI Gateway에 사용자별 예산 기능이 추가됐습니다. 이제 특정 팀원에게 귀속된 API 키의 지출만 중단하고, 팀 귀속 프로덕션 키는 해당 키와 팀 예산이 남아 있는 한 계속 실행할 수 있습니다. 달라지는 것은 모델 가격이 아니라 팀의 비용 통제 방식입니다.

Vercel AI Gateway 사용자별 예산, 한 문장으로 정리하면

사람이 소유한 에이전트 키에는 개인별 한도를 부여하고, 공용 프로덕션 키는 팀 소유로 유지합니다.

작동 원리는 이것이 전부입니다. 사용자 예산은 같은 멤버에게 귀속된 모든 AI Gateway API 키의 지출을 합산합니다. 한도를 소진하면 해당 키의 새 요청은 HTTP 402를 반환하지만, 그 사용자의 예산에 포함되지 않는 트래픽은 계속 처리될 수 있습니다.

이 기능이 나오기 전에도 Vercel은 팀, 프로젝트 또는 개별 API 키 단위로 한도를 설정할 수 있었습니다. 새로 추가된 사용자 범위는 기존 통제 수단과 나란히 작동하며 다른 문제를 해결합니다. 한 개발자가 Codex, Claude Code, Cursor 또는 또 다른 무인 워크로드에서 여러 키를 사용하더라도, 재무 담당자는 그 사람의 전체 게이트웨이 지출에 하나의 상한을 적용할 수 있습니다.

사용자에게 실제로 귀속되는 지출은 무엇인가

핵심 설정은 **Spend attribution(지출 귀속)**입니다. 예산을 계산할 때 Vercel이 API 키에 붙이는 소유자 표시에 해당합니다.

새 키는 기본적으로 User에 귀속됩니다. 귀속 정보가 없는 기존 키는 이전 동작과의 호환성을 위해 Team 귀속 상태를 유지합니다. metadata.spendAttribution 없이 API로 만든 키 역시 Team 지출로 계산됩니다.

이에 따라 요청 경로는 네 가지로 나뉩니다.

지출 금액이 이 예산들 사이에 나뉘는 것은 아닙니다. 하나의 요청이 해당되는 모든 계량기에 동시에 반영됩니다. 멤버 귀속 키로 보낸 요청은 키 예산, 해당 멤버의 사용자 예산, 팀 예산에 모두 여유가 있어야 합니다. 셋 중 하나라도 소진되면 요청이 중단됩니다.

따라서 공용 프로덕션 트래픽은 의도적으로 분리해야 합니다. 개발자가 고객용 앱에 쓸 새 키를 만들면 기본적으로 그 개발자에게 귀속됩니다. 그러면 개인 한도가 앱까지 멈출 수 있습니다. AI Gateway의 API Keys 페이지에서 해당 키의 Spend attribution을 Team으로 바꾸면 키 예산과 팀 예산만 적용됩니다.

사용자별 예산이 바꾼 비용 계산법

사용자별 한도는 공동 부담하던 위험을 청구서가 나오기 전에 개인별로 배정할 수 있는 한도로 바꿉니다.

다음은 Vercel 가격이 아니라 가정한 예시입니다. 8명으로 구성된 팀의 월간 팀 예산이 $1,000이라고 하겠습니다. 일곱 명에게는 월 $50의 기본 한도를 주고, 더 많은 에이전트 작업을 실행하는 리드 한 명에게는 $150의 사용자 지정 예산을 줍니다.

개인 키에 적용되는 전체 한도는 다음과 같습니다.

7 × $50 + 1 × $150 = $500 per month

이 $500는 팀 예산과 별도로 추가되는 금액이 아니라 그 안에 포함됩니다. 멤버 귀속 키가 먼저 $500를 모두 사용하면 같은 $500가 $1,000의 팀 상한에도 반영됩니다. 이 단순화한 사례에서는 팀 귀속 프로덕션 트래픽이 팀 한도에 도달하기 전까지 $500를 더 쓸 수 있습니다.

다만 어느 금액도 따로 예약되지는 않습니다. 프로덕션이 먼저 지출할 수 있으며, 모든 요청에는 여전히 팀 상한 아래의 여유가 필요합니다. 변화의 핵심은 더 좁습니다. 한 팀원이 귀속 키를 통해 개인 한도를 넘게 써서 다른 모든 사람의 접근까지 막는 상황을 방지할 수 있다는 점입니다.

이는 에이전트마다 강제 가능한 프로젝트 상한을 두려면 각각 별도 프로젝트가 필요한 OpenAI의 기본 통제 방식과 다릅니다. OpenAI API 예산 통제 가이드에서 이 격리 모델을 자세히 설명합니다. Vercel의 사용자 범위는 사람마다 프로젝트를 만들지 않아도 여러 멤버 귀속 키를 한꺼번에 포괄할 수 있습니다.

이 기능이 토큰 가격을 낮추는 것은 아닙니다. AI Gateway는 토큰 마크업이나 플랫폼 수수료 없이 제공업체의 정가를 그대로 청구합니다. 장점은 더 저렴한 추론이 아니라 손실 범위를 제한하고 비용 소유자를 명확히 하는 데 있습니다.

워크플로가 실질적으로 달라지는 네 가지 팀

여러 코딩 에이전트를 운용하는 제품 엔지니어링 리드

팀 전체에 하나의 기본 사용자 예산을 설정한 뒤, 사용량이 많은 사람에게만 사용자 지정 금액을 부여합니다. 개발자는 에이전트마다 별도 키를 사용하면서도 모든 키의 지출을 하나의 개인 상한으로 합산할 수 있습니다.

가장 큰 효과는 밤새 실행되는 루프의 최대 비용이 정해진다는 점입니다. 한 에이전트가 실패한 작업을 계속 재시도해도 그 개발자의 요청만 중단되며, 팀 귀속 프로덕션 서비스까지 자동으로 내려가지는 않습니다.

고객 수익성을 지켜야 하는 에이전시 운영자

운영자마다 멤버 귀속 키와 기본 한도를 제공합니다. 모델 사용량이 많은 마이그레이션이나 짧은 고객 프로젝트를 맡은 사람에게는 사용자 지정 예산을 추가합니다.

이렇게 하면 예외의 주체가 명확해집니다. 모든 팀원의 한도를 올리거나 에이전시 전체 예산만 유일한 차단 장치로 삼지 않고도 한 사람의 추가 지출을 승인할 수 있습니다.

사람과 프로덕션을 분리하는 플랫폼 리드

모든 AI Gateway 키를 점검하고 공용 서비스 키는 Team으로 지정합니다. 개인 코딩 에이전트 키는 만든 사람에게 귀속된 상태로 둡니다.

그 결과 장애 범위가 분리됩니다. 한 사람의 한도가 소진되면 그 사람의 에이전트 트래픽만 멈추고, 고객용 워크로드는 자체 키 예산이나 팀 예산이 소진될 때까지 계속 실행됩니다.

정책을 책임지는 재무 또는 운영 리드

Owner는 전체 Owner 역할을 넘기지 않고도 AI Gateway Budget Manager 권한을 부여할 수 있습니다. 이 권한을 받은 운영자는 사용자 예산, 기본값, 키 귀속을 관리할 수 있으며, Contributor를 제외한 모든 팀 역할은 예산 페이지를 볼 수 있습니다.

정책을 실제로 운영할 담당자가 생긴다는 의미입니다. 재무팀은 비용 범위를 정하고 엔지니어링팀은 이를 확인할 수 있으며, 예산을 바꿀 때마다 Vercel 팀 전체를 소유한 한 사람을 기다릴 필요가 없습니다.

프로덕션을 개인에게 묶지 않는 Vercel AI Gateway 예산 설정

Vercel 사용자 예산을 사용하려면 CLI 59.6.2 이상이 필요합니다. 아래 명령은 이번 작업에서 버전 59.6.2를 기준으로 검증됐습니다.

1. 1

   CLI 업그레이드 및 버전 확인

   문서에 나온 업그레이드를 실행한 뒤, 설치된 버전이 59.6.2 이상인지 확인합니다.

   vercel upgrade
   vercel --version

2. 2

   기본 사용자 한도 설정

   이 예시는 사용자 지정 예산이 없는 각 멤버에게 월 $50의 개별 한도를 부여합니다. 그룹 전체가 $50를 공유하는 방식이 아닙니다.

   vercel ai-gateway budgets defaults set user --limit 50 --refresh-period monthly

3. 3

   사용량이 많은 사용자에게 별도 한도 부여

   사용자 지정 예산은 해당 사용자의 기본값을 대체합니다. Vercel에는 이메일 주소, 사용자 이름 또는 사용자 ID를 입력할 수 있습니다.

   vercel ai-gateway budgets set user lead@example.com --limit 150 --refresh-period monthly
   vercel ai-gateway budgets list

4. 4

   공용 키를 팀 소유로 변경

   AI Gateway를 열고 API Keys로 이동한 뒤, 고객용 또는 공용 워크로드의 키를 각각 편집해 Spend attribution을 Team으로 설정합니다. 새 키의 기본값은 User이므로 프로덕션 키를 만들 때마다 이 검토를 포함해야 합니다.

5. 5

   사람이 대응해야 할 시점에 알림 추가

   사용자 지정 예산은 한도의 50%, 75%, 100%에서 이메일을 보낼 수 있습니다. 알림은 기본적으로 꺼져 있고 기본 예산은 알림을 보내지 않으므로, 특정 담당자가 중단 전에 경고 이메일을 받아야 한다면 사용자 지정 예산을 추가합니다.

월간 예산은 매월 1일 자정(UTC)에 초기화됩니다. 일간 예산은 매일 자정(UTC), 주간 예산은 월요일 자정(UTC)에 초기화되며, none을 선택하면 초기화되지 않는 누적 한도가 만들어집니다.

스테이징에서 차단과 재개 경로 테스트하기

이 글을 작성할 때 사용할 수 있는 별도의 팀과 키가 없어 실제 Vercel 팀 예산은 변경하지 않았습니다. 따라서 안전한 테스트는 스테이징에서 직접 실행해야 합니다. 아래의 402 동작과 반영 시간은 Vercel이 문서로 명시한 조건이며, 이번 작업에서 특정 계정으로 측정한 벤치마크가 아닙니다.

전용 스테이징 멤버와 그 멤버에게 귀속된 키를 사용합니다. 프로덕션 키로 이 테스트를 실행해서는 안 됩니다.

1. 1

   현재 지출부터 확인

   vercel ai-gateway budgets list로 스테이징 멤버의 현재 기간 지출을 확인합니다. 이미 문서에 명시된 최소값 $1를 넘었다면 새 테스트 트래픽 비용을 발생시키지 않고도 한도에 도달하게 할 수 있습니다.

2. 2

   스테이징 사용자의 상한 낮추기

   예산을 수정해도 현재 기간에 이미 누적된 지출은 그대로 유지됩니다. 스테이징 사용자의 한도를 $1로 설정한 뒤 변경 사항이 반영될 시간을 둡니다.

   vercel ai-gateway budgets set user staging@example.com --limit 1 --refresh-period monthly

3. 3

   해당 멤버의 키로 요청 한 번 전송

   멤버 귀속 스테이징 키를 AI_GATEWAY_API_KEY로 내보낸 뒤, Vercel 문서에 나온 원시 HTTP 요청 형식을 사용합니다.

   curl https://ai-gateway.vercel.sh/v1/chat/completions \
     -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "openai/gpt-5.6-sol",
       "messages": [
         {
           "role": "user",
           "content": "Invent a new holiday and describe its traditions."
         }
       ]
     }'

   사용자 예산이 활성화되고 소진되면 요청은 HTTP 402를 반환해야 하며, 오류 유형은 quota_for_entity_exceeded여야 합니다. 402의 오류 유형이 다르다면 예산이 아니라 팀의 크레딧 잔액이 원인일 수 있습니다.

4. 4

   한도를 올린 뒤 다시 요청

   사용자 지정 한도를 budgets list에 표시된 지출보다 높게 올립니다. 아래 문서의 명령 형식은 $100를 사용합니다.

   vercel ai-gateway budgets set user staging@example.com --limit 100 --refresh-period monthly

   예산 변경은 보통 수십 초 안에 반영되지만 활성 키에는 약 5분까지 걸릴 수 있습니다. 잠시 기다린 뒤 같은 요청을 다시 보냅니다. 적용 가능한 다른 키 예산이나 팀 예산이 소진되지 않았다면 요청이 재개돼야 합니다.

5. 5

   원래 정책으로 복원

   스테이징 사용자를 계획한 사용자 지정 한도로 되돌립니다. 사용자 지정 예산을 삭제해도 기본 예산이 있으면 사용자는 그 값으로 돌아가므로 항상 차단이 풀리는 것은 아닙니다. 해당 기본 예산까지 이미 소진됐다면 트래픽은 계속 차단됩니다.

놓치기 쉬운 두 가지 적용 경계

첫째, BYOK 지출은 모든 AI Gateway 예산의 적용 대상에서 제외됩니다. 사용자가 보유한 제공업체 자격 증명을 게이트웨이에 연결하면 지출은 별도로 계량되며 사용자 상한으로 제한할 수 없습니다. 실패한 BYOK 요청이 Vercel 시스템 자격 증명으로 대체 처리돼 팀의 AI Gateway 크레딧 잔액에 청구될 수도 있습니다.

둘째, 현재 Vercel의 각 페이지는 앱 토큰에 관해 서로 다른 내용을 안내합니다. 8월 31일 출시 공지는 사용자 한도가 귀속된 API 키와 앱 토큰을 함께 포괄한다고 설명합니다. 반면 현재 Budgets 문서는 앱 토큰에 멤버 귀속 정보가 없으며 사용자 예산에 절대 포함되지 않는다고 명시합니다.

월요일에 바로 할 일

여러 팀원이 각자의 AI Gateway 키로 코딩 에이전트나 다른 무인 작업을 실행하고 있다면 이번 주에 적용할 가치가 있습니다. 트래픽이 프로젝트 OIDC 토큰이나 BYOK 제공업체 자격 증명만 사용한다면 사용자 예산으로 제어할 수 없으므로 기다려도 됩니다. 키 하나와 팀 예산 하나만 쓰는 단독 운영자에게는 영향이 크지 않습니다.

월요일에는 모든 게이트웨이 키를 PERSON 또는 SHARED로 분류합니다. 먼저 공용 프로덕션 키의 귀속을 Team으로 옮깁니다. 그런 다음 월간 사용자 기본값 하나를 정하고, 비즈니스상 설명할 수 있는 예외에만 사용자 지정 예산을 추가합니다. 마지막으로 스테이징에서 402 차단, 한도 상향, 재개까지 전 과정을 검증합니다. 프로덕션이 한 사람의 한도 밖에 있고 운영자가 어떤 한도 때문에 요청이 막혔는지 알아낼 수 있어야 예산 설정이 완료된 것입니다.

AI 비용 통제와 프로덕션 워크플로에 관한 실용적인 내용을 더 받아보려면 뉴스레터에 가입하세요.