sam-manage/docs/veo3.1/GOOGLE_API_BILLING_GUIDE.md

# Google Cloud API 비용 모니터링 & 결제 가이드

> YouTube Shorts AI 생성기 (Veo 3.1 + Gemini + TTS) 운영 시 참고

---

## 1. 결제 반영 시점

Google Cloud 결제 데이터는 **실시간이 아닙니다**.

| 항목 | 반영 지연 | 비고 |
|------|----------|------|
| API 호출 횟수 | 실시간 ~ 수분 | API 대시보드에서 확인 |
| 비용 (결제 보고서) | **24~48시간** | 결제 > 보고서에서 확인 |
| 크레딧 차감 | 24~48시간 | 비용 반영 후 자동 차감 |
| 청구서 발행 | 월 1회 (익월 초) | 결제 > 거래에서 확인 |

> Vertex AI (Veo 3.1) 같은 생성형 AI 서비스는 특히 반영이 느린 편이므로, 오늘 사용한 비용이 내일~모레 나타나는 것은 정상입니다.

---

## 2. 비용 확인 메뉴 (Google Cloud Console)

### 2-1. API 호출 횟수 (실시간에 가장 가까움)

**경로**: `API 및 서비스` → `대시보드` → `Vertex AI API` 클릭

```
Google Cloud Console
├── 좌측 햄버거 메뉴 (≡)
│   └── API 및 서비스
│       └── 사용 설정된 API 및 서비스
│           └── "Vertex AI API" 클릭
│               └── 측정항목 탭
│                   ├── 요청 수 (실시간)
│                   ├── 오류율
│                   └── 지연 시간
```

**직접 URL**: `https://console.cloud.google.com/apis/api/aiplatform.googleapis.com/metrics?project=PROJECT_ID`

### 2-2. 할당량 (Quotas) 확인

**경로**: `IAM 및 관리자` → `할당량 및 시스템 한도`

```
Google Cloud Console
├── 좌측 햄버거 메뉴 (≡)
│   └── IAM 및 관리자
│       └── 할당량 및 시스템 한도
│           └── 필터: "aiplatform" 또는 "Vertex AI"
│               ├── 분당 요청 수 제한
│               ├── 동시 요청 수 제한
│               └── 일일 요청 수 제한
```

**직접 URL**: `https://console.cloud.google.com/iam-admin/quotas?project=PROJECT_ID`

> **참고**: Veo 3.1 같은 생성형 AI 서비스는 리전별 공유 용량(pooled capacity)으로 운영되어, 할당량 대시보드에서 사용률이 0%로 나올 수 있습니다. API 대시보드(2-1)에서 요청 횟수를 확인하는 것이 더 정확합니다.

### 2-3. 비용 보고서 (가장 정확한 비용)

**경로**: `결제` → `보고서`

```
Google Cloud Console
├── 좌측 햄버거 메뉴 (≡)
│   └── 결제
│       └── 보고서
│           ├── 필터: 서비스 → "Vertex AI"
│           ├── 기간: 오늘 / 이번 달 / 사용자 지정
│           └── 그룹화: 서비스 / SKU / 프로젝트
```

**직접 URL**: `https://console.cloud.google.com/billing/reports?project=PROJECT_ID`

### 2-4. 크레딧 잔액 확인

**경로**: `결제` → `개요` 또는 `크레딧`

```
Google Cloud Console
├── 좌측 햄버거 메뉴 (≡)
│   └── 결제
│       ├── 개요 → 크레딧 잔액 표시
│       └── 크레딧 → 상세 크레딧 내역
│           ├── 무료 체험 크레딧 ($300)
│           ├── 만료일
│           └── 사용량
```

---

## 3. 서비스별 예상 비용 (1회 영상 생성 기준)

| 서비스 | API | 사용량 | 예상 비용 |
|--------|-----|--------|----------|
| 시나리오 생성 | Gemini 3.0 Flash | ~2,000 토큰 | ~$0.001 |
| 나레이션 생성 | Google Cloud TTS | ~200자 (6장면) | ~$0.01 |
| 영상 클립 생성 | Veo 3.1 Preview | 48초 (8초 x 6클립) | ~$7.20 |
| BGM | 로컬 파일 사용 | - | $0 |
| 영상 합성 | FFmpeg (로컬) | - | $0 |
| **합계** | | | **~$7.21** |

### 크레딧 기준 예상 제작 가능 수량

| 크레딧 | 영상 수 | 비고 |
|--------|---------|------|
| $300 (무료 체험) | ~41개 | 90일 내 사용 |
| $100 추가 충전 시 | ~13개 | |

---

## 4. 비용 절약 팁

### 모델 선택
- **테스트**: `veo-3.1-fast-generate-preview` (Fast 모델, 비용 ~60% 절감)
- **최종본**: `veo-3.1-generate-preview` (Standard 모델, 고화질)

### 해상도 설정
- **테스트**: `720p` (현재 설정)
- **최종본**: `1080p` (비용 증가 가능)

### 장면 수 최적화
- 6개 장면 대신 **5개 장면**으로 줄이면 클립 1개분 절약 (~$1.20)
- 시나리오 생성 시 Gemini 프롬프트에서 장면 수 조절 가능

---

## 5. 예산 알림 설정 (권장)

크레딧 소진을 방지하기 위해 예산 알림을 설정하세요.

**경로**: `결제` → `예산 및 알림` → `예산 만들기`

```
설정 예시:
├── 예산 이름: "Veo3.1 영상 생성"
├── 프로젝트: codebridge-chatbot
├── 서비스: Vertex AI
├── 예산 금액: $50 (또는 원하는 금액)
└── 알림 기준:
    ├── 50% 도달 시 이메일
    ├── 90% 도달 시 이메일
    └── 100% 도달 시 이메일
```

---

## 6. SAM 프로젝트 내 비용 추적

SAM의 `video_generations` 테이블에서 `cost_usd` 컬럼으로 예상 비용을 자체 추적합니다.

```sql
-- 전체 예상 비용 합계
SELECT SUM(cost_usd) as total_cost, COUNT(*) as total_videos
FROM video_generations
WHERE status = 'completed';

-- 일별 비용 추이
SELECT DATE(created_at) as date, SUM(cost_usd) as daily_cost, COUNT(*) as count
FROM video_generations
WHERE status = 'completed'
GROUP BY DATE(created_at)
ORDER BY date DESC;
```

> **주의**: `cost_usd`는 코드 내 추정치이므로 실제 Google 결제 금액과 차이가 있을 수 있습니다. 정확한 비용은 Google Cloud 결제 보고서에서 확인하세요.

---

## 참고 링크

- [Vertex AI 할당량 및 한도](https://docs.cloud.google.com/vertex-ai/docs/quotas)
- [생성형 AI 할당량 및 시스템 한도](https://docs.cloud.google.com/vertex-ai/generative-ai/docs/quotas)
- [Vertex AI 가격 책정](https://cloud.google.com/vertex-ai/pricing)
- [Google Cloud 결제 문서](https://cloud.google.com/billing/docs)