AI Gateway에서 이제 팀 및 프로젝트별 지출 예산 설정을 지원합니다
요약
Vercel AI Gateway가 팀 및 프로젝트 단위의 지출 예산 설정 기능을 지원합니다. API 키뿐만 아니라 더 넓은 범위에서 달러 한도를 설정하여 비용을 관리하고, 한도 도달 시 요청을 차단하거나 이메일 알림을 받을 수 있습니다.
핵심 포인트
- 팀, 프로젝트, API 키 단위로 세밀한 지출 한도 설정 가능
- 예산 한도 초과 시 추가 요청을 자동으로 차단하는 기능 제공
- 사용량의 50%, 75%, 100% 도달 시 이메일 알림 설정 가능
- CLI를 통해 예산 설정, 검사 및 제거 관리 지원
AI Gateway 지출 예산 (spend budgets)을 이제 개별 API 키뿐만 아니라 팀(team) 또는 프로젝트(project) 단위로 범위를 지정할 수 있습니다. 특정 범위에 달러 한도를 설정하면, 게이트웨이가 해당 한도에 맞춰 지출을 측정하며, 한도에 도달하면 예산이 재설정되거나 한도를 높일 때까지 추가 요청을 중단합니다.
예산은 세 가지 범위 중 하나에 연결됩니다. 하나의 요청은 여러 예산에 해당할 수 있으며, 모든 예산을 통과해야 합니다. 만약 다른 예산에 여유가 있더라도, 단 하나라도 한도를 초과하면 해당 요청은 거부됩니다.
BYOK (Bring Your Own Key) 지출은 기본적으로 예산에 포함되지 않습니다.
AI Gateway Budgets 탭에서 예산을 설정하고 추적하세요. Overview(개요)에서는 모든 범위에 대한 지출을 한도 대비 상세히 보여주므로, 요청이 거부되기 전에 무엇이 한도에 근접했는지 또는 초과했는지 확인할 수 있습니다.
이메일 지출 알림 (email spend alerts)을 켜면, 사용량이 갱신 주기 내에서 한도의 50%, 75%, 또는 100%를 초과할 때 팀의 사용량 알림 수신자에게 통지합니다. 알림은 기본적으로 꺼져 있으며 정보 제공용입니다. 알림은 요청을 차단하지 않으며, 오직 예산 한도만이 요청을 차단합니다.
프로젝트 또는 API 키에 대해 기본 예산 (default budget)을 설정하면, 명시적인 예산이 없는 모든 항목은 자동으로 이를 상속받습니다. 명시적인 예산은 항상 기본 예산보다 우선합니다.
CLI에서 팀 및 프로젝트 예산을 설정, 검사 및 제거할 수 있습니다. 갱신 주기 (refresh period)는 daily, weekly, monthly (기본값), 또는 누적 한도를 위한 none입니다.
자세한 내용은 budgets documentation을 읽어보세요.
Scopes (범위)
Manage budgets in the dashboard (대시보드에서 예산 관리)
Manage budgets from the CLI (CLI에서 예산 관리)
| 범위 (Scope) | 다음 항목의 지출 제한 (Caps spend for) |
|---|---|
| Team (팀) | 팀이 게이트웨이를 통해 실행하는 모든 요청 |
| Project (프로젝트) | 단일 프로젝트에 귀속된 모든 요청 |
| API key (API 키) | 단일 API 키 |
AI 자동 생성 콘텐츠
본 콘텐츠는 Vercel AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기