Vercel Beam 무료 사용 조건: beam과 beam-free의 과금 전환 차이

필요한 곳부터 보기: 두 ID의 종료 후 차이 · 요청 파일 점검 예제 · 팀 rewrite 확인 · 예산이 0원 차단을 보장하지 않는 이유

beam은 유료 전환, beam-free는 제공 중단입니다

Vercel은 2026년 10월 16일 Beam의 AI Gateway 제공을 발표했습니다. 이 날짜는 Gateway 제공 발표일이며 모델 자체의 최초 공개일로 설명하지 않습니다. 발표는 Reflection이 서비스하는 출시 기간 동안 무료라고 안내하면서 두 ID의 이후 동작을 구분합니다. Beam 공식 제공 발표

선택	공식 안내의 무료 종료 후 동작	선택 전 결정할 점
reflection/beam · Reflection 제공 경로	서비스 중단 없이 유료 가격으로 전환	종료 후 유료 사용을 허용할지와 적용 단가
reflection/beam-free	해당 무료 모델 제공 중단	실패·중단을 사용자와 작업 큐에 어떻게 알릴지

무료 종료 날짜·시각과 종료 후 응답 코드는 아직 확인되지 않았습니다. 종료 계획은 아래 두 ID의 공식 조건을 기준으로 정하고, 실제 종료 공지가 나오면 갱신해야 합니다.

무료 적용 조건에는 Reflection 제공 경로가 포함됩니다

reflection/beam이라는 ID만 보고 모든 요청이 무료라고 판단하면 안 됩니다. 10월 18일 확인한 공식 Beam 모델 페이지에는 Reflection은 무료, Nebius·Baseten·Together AI는 각각 유료 단가로 표시돼 있습니다. 일반 ID의 무료 안내는 Reflection 제공 경로에 관한 조건입니다. 현재 Beam 제공자별 가격표

모델 선택과 제공자 선택도 구분합니다. providerOptions.gateway.order는 제공자 우선순위이고 only는 허용 제공자를 제한합니다. Reflection만 의도한다면 선호 목록에 넣었다는 사실과 다른 제공자를 제외했다는 사실을 혼동하지 마세요. 제공자 order·only 설정

연결 설치부터 확인해야 한다면 Muse Wonder의 AI Gateway 연결 안내를 참고할 수 있습니다. 여기서는 이미 연결한 에이전트의 실제 요청과 무료 종료 뒤 비용 경계를 점검합니다.

1. 화면의 모델 이름보다 실제 요청 파일을 확인하기

사용 중인 에이전트·SDK 버전과 실제 전송 설정을 먼저 기록합니다. 화면에서 Beam을 골라도 별칭·프로필·환경별 설정이 다른 ID를 보낼 수 있으므로 요청의 model과 Gateway 옵션을 대조하세요. 비밀값과 업무 프롬프트를 제거한 시험 요청을 사용합니다.

아래는 AI Gateway Chat Completions API용 요청 본문 예시입니다. 특정 에이전트의 설정 파일이나 AI SDK의 함수 인수를 그대로 대체하는 파일은 아닙니다. providerOptions.gateway 경로는 해당 API의 공식 fallback·제공자 설정과 대조했습니다. Gateway Chat Completions 형식

{
  "model": "reflection/beam-free",
  "messages": [
    { "role": "user", "content": "Reply with OK." }
  ],
  "providerOptions": {
    "gateway": {
      "only": ["reflection"]
    }
  }
}

이 예시는 무료 전용 ID와 Reflection 제한을 지정하고 요청 수준의 models fallback 필드를 넣지 않았습니다. 이 JSON만으로 팀의 rewrite나 에이전트 자체 재시도가 사라지는 것은 아닙니다. Gateway가 실제로 이 요청을 수락하는지와 어떤 모델이 서비스하는지도 원격 확인이 필요합니다.

네 가지 요청 파일을 실제 로컬 점검기로 비교했습니다

요청 JSON·점검기·테스트 ZIP을 풀어 실행합니다. Node.js 24.20.0의 기본 기능만 사용하며 API 키·외부 패키지가 필요 없습니다.

node inspect-request.mjs request.example.json
node --test inspect-request.test.mjs

같은 기본 요청에서 모델 ID·제공자·fallback을 하나씩 바꿔 CLI로 실행한 결과입니다. 종료 코드 1은 편집부의 요청 파일 점검에서 검토 대상으로 분류됐다는 뜻이며, Gateway가 요청을 거부했다는 뜻은 아닙니다.

실행한 요청	실제 종료 코드	실제 findings와 의미
beam-free + only: reflection	0	빈 목록. 점검기의 제한된 파일 조건에 맞음
기본 요청에서 model만 beam으로 변경	1	model_is_not_beam_free — 무료 종료 시 중단하는 ID인지 재검토
only를 빼고 order에 reflection 지정	1	reflection_not_exclusive unreviewed_gateway_field — 우선순위와 제공자 제한을 구분
beam-free에 beam fallback 추가	1	model_fallback_field_present — 무료 모델 실패 뒤의 대체 호출 검토

네 요청 본문·실제 출력·종료 코드를 공개합니다. 모든 결과의 apiCalled는 false입니다. order는 공식 API 옵션이지만 이 점검기가 자동 승인하는 필드는 아니므로 수동 검토로 분류합니다. 이 점검기는 Gateway 전체 스키마 검증기가 아닙니다.

이 점검 결과로 알 수 있는 범위

로컬 테스트 8개와 위 CLI 비교 4건을 실행했습니다. 테스트 출력과 점검 코드를 확인할 수 있습니다. 팀 rewrite·에이전트 재시도·실제 서비스 모델·과금은 파일 검사로 확인되지 않으므로 아래 단계에서 별도 대조합니다.

2. beam-free 실패 후 유료 fallback이 남아 있는지 보기

Gateway는 providerOptions.gateway.models로 대체 모델을 지정할 수 있습니다. 기본 모델의 제공 경로가 실패하면 다음 모델을 시도하는 설정입니다. 따라서 무료 모델이 중단돼도 다른 유료 모델로 이어지는 구성이면 “무료 종료 시 멈춤”이라는 운영 의도와 달라질 수 있습니다. 공식 모델 fallback 동작

점검 위치	찾을 내용	확인할 비용 경로
Gateway 요청 본문	providerOptions.gateway.models	beam-free 다음에 일반 Beam이나 다른 유료 모델이 있는지
제공자 옵션	only와 order	Reflection 외 제공 경로를 허용했는지
에이전트·앱 코드	실패 시 모델 교체·다른 API 키·별도 제공업체 호출	Gateway 요청 안에 보이지 않는 대체 호출이 있는지
서버·배포 환경별 설정	로컬과 운영의 모델 프로필·변수·공유 설정	시험 파일과 실제 운영 요청이 같은지

Reflection만 only에 넣어도 다른 Reflection 제공 모델로 fallback할 가능성까지 없어지는 것은 아닙니다. 모델 후보와 제공자 제한은 각각 확인해야 합니다. 기존의 신뢰성 확보용 fallback을 제거하려면 해당 기능이 중단될 때의 처리도 함께 정하세요.

3. 팀 rewrite는 요청한 모델을 바꿀 수 있습니다

AI Gateway 팀 라우팅 규칙은 같은 팀의 자격증명으로 보낸 요청에 적용됩니다. rewrite는 요청 모델을 다른 모델로 바꾸며, deny는 모델을 차단합니다. 앱 코드의 model이 그대로여도 서비스 모델은 달라질 수 있습니다. 팀 라우팅 규칙과 적용 범위

다음은 문서에 따른 읽기 명령입니다. 자신의 CLI 버전과 실제 키가 속한 팀을 기록한 뒤 조회합니다. 편집부는 독자의 계정 규칙을 조회하거나 바꾸지 않았습니다.

vercel --version
vercel ai-gateway rules list --scope YOUR_TEAM --format json

reflection/beam-free 또는 대체 모델에 걸린 rewrite·deny와 목적지를 확인하세요. 가상 모델로 보내는 규칙이면 그 안의 구성까지 봅니다. 규칙은 fallback 후보에도 적용되고 기존 only·fallback 옵션은 목적지에 보존되므로, “모든 rewrite가 무조건 유료 호출로 이어진다”거나 “only 하나면 비용 경로가 모두 잠긴다”고 설명할 수는 없습니다.

의도하지 않은 규칙이 발견되면 요청 모델, 실제 목적지, 허용 제공자와 다른 앱의 사용 범위를 묶어 담당자에게 전달하세요. 팀 전체 규칙을 즉시 삭제하는 방식보다 해당 무료 시험의 중단·유료 전환 정책부터 합의하는 편이 변경 영향을 판단하기 쉽습니다.

4. 요청 모델과 실제 서비스 모델·제공자를 기록하기

작은 시험을 원격에서 실행할 때는 요청 시각·ID와 모델·제공자·사용량·비용을 같은 건으로 연결합니다. Gateway Logs의 Model은 실제 서비스 모델, Provider는 서비스 제공자를 표시하고 상세 Routing에서 시도 경로를 확인할 수 있습니다. 요청 로그와 Routing 상세

관측값	판단할 내용
요청 파일에 reflection/beam-free	클라이언트가 보낼 모델 선택. 실제 제공 결과는 별도 확인
로그의 서비스 모델·제공자가 의도와 다름	fallback·rewrite·가상 모델·인증 팀을 대조
Cost에 0으로 보고된 시험 요청	해당 요청의 보고 비용. 계정 전체 비용의 증거는 아님
Usage·Cost가 —	값이 보고되지 않았다는 뜻. 0원으로 환산하지 않음

최신 로그에는 수집 지연이 있을 수 있습니다. 결과가 바로 보이지 않으면 같은 요청 ID와 시간 범위로 다시 확인하세요. 무료 제공·라우팅·비용 대조 기록표에 비밀값을 제거한 요청, 실제 서비스 경로, 사용량 화면의 보관 위치를 남길 수 있습니다. 이 양식에는 실제 호출 성공 기록이 들어 있지 않습니다.

5. API 키 예산은 0원 보장이나 계정 전체 상한이 아닙니다

AI Gateway API 키에는 별도 예산을 둘 수 있습니다. 사용 키의 이름·ID·예산·사용액·갱신 주기를 확인하고, 예산이 없는 Unlimited 상태와 금액이 설정된 상태를 구분하세요. API 키와 예산 연결

10월 18일 확인한 예산 문서는 한도 최소 1달러와 변경 반영 지연을 안내합니다. 또 예산은 요청 시작 시 검사하는 소프트 한도여서 한도를 넘기는 요청이 완료돼 총액이 조금 초과할 수 있습니다. “0달러로 설정하면 유료 호출이 전혀 없다”는 방식으로 안내해서는 안 됩니다. 예산 최소값·반영 지연·소프트 한도

API 키 예산은 그 키의 사용을 제한합니다. 다른 키·인증 경로와 도구·컴퓨팅 비용까지 합친 계정 전체의 0원 보장은 아닙니다. 무료 종료 뒤 유료 호출을 원치 않는다면 모델·fallback·rewrite 정책과 기능 중단 처리를 먼저 정하고, 예산은 추가 비용 통제 수단으로 사용하세요.

전체 도구의 과금 구조를 비교하려면 AI 코딩 에이전트 구독·토큰 비용 비교를 참고할 수 있습니다. 이번 글의 한시 무료 조건을 다른 모델이나 도구의 무료 이용 조건으로 넓혀 적용하지 않습니다.

무료 종료 전 정할 두 가지 운영 계획

원하는 동작	종료 전에 준비할 일	확인할 결과
무료 제공이 끝나면 멈춤	beam-free 선택, 유료 대체 경로 검토, 실패 시 중단 안내·작업 보존	다른 모델로 자동 우회하지 않고 사용자가 중단 상태를 알 수 있는지
검토한 범위에서 유료로 계속 사용	일반 ID의 실제 제공 경로·새 단가·예산·변경 담당자 확인	해당 요청의 서비스 모델·제공자·비용이 승인한 조건과 맞는지

무료 종료 시 기능을 중단할지, 검토한 요금으로 계속 제공할지를 먼저 정합니다. 실제 종료 응답과 새 단가는 공지·로그를 확보한 뒤 운영 계획에 반영하세요.

자주 묻는 질문

일반 Beam ID는 무료가 끝나면 자동으로 유료가 되나요?

공식 발표는 Reflection 경로의 reflection/beam이 무료 기간 종료 후 유료 가격으로 전환된다고 안내합니다. 중단을 원한다면 beam-free의 제공 종료 동작과 대체 호출 경로를 함께 확인하세요. 정확한 종료 날짜는 발표에 명시돼 있지 않습니다.

beam-free만 지정하면 계정 전체 비용도 0원인가요?

해당 모델 ID의 무료 종료 동작을 구분하는 장치입니다. 유료 fallback·팀 rewrite·다른 키의 요청과 도구·컴퓨팅 비용까지 없어진다는 뜻은 아닙니다. 요청 파일, 실제 서비스 경로와 비용 범위를 각각 확인해야 합니다.

무료 기간 종료 날짜와 이후 단가는 어디서 확인하나요?

Vercel의 Beam 공식 발표·모델 페이지와 후속 공지를 확인합니다. 제공자별 현재 가격과 무료 종료 후 단가는 구분해 기록하세요. 현재 다른 제공자의 단가를 Reflection의 향후 가격으로 대신 쓰지 않습니다.

가격 확인일과 갱신 기준

발표일은 2026년 10월 16일, 이 글의 조건·문서·로컬 예제 확인일은 10월 18일입니다. 무료 종료일, 제공자별 가격, 모델 ID나 라우팅·예산 동작이 바뀌면 해당 항목과 확인 시각을 함께 갱신합니다. 확인하지 않은 날짜·단가·종료 응답은 미확인으로 남깁니다.