# Gemini Pro API セットアップガイド

## 現在の状況

### Google One Proについて
**重要:** Google One Pro会員の特典とGemini APIの料金は**別物**です。

- **Google One Pro特典**: Gmail、Docs、DriveでのGemini機能が使える
- **Gemini API (開発者向け)**: アプリ開発用のAPI、無料枠と有料枠がある

**このアプリで使用しているのは開発者向けGemini APIです。**

---

## API制限の解除方法

### 方法1: 時間を待つ（無料）
現在レート制限エラーが出ている場合:

1. **1-2分待つ** - RPM(15回/分)制限は1分で解除
2. **アプリを再起動** - 内部カウンターがリセット
3. **5秒以上間隔を空けて解析** - 自動的に待機するようになりました

### 方法2: 別のGoogleアカウントを使用
新しいAPIキーを取得:

1. 別のGoogleアカウントでログイン
2. [Google AI Studio](https://aistudio.google.com/apikey) にアクセス
3. 新しいAPIキーを生成
4. `lib/secrets.dart` のAPIキーを差し替え
5. アプリを再ビルド

**注意:** 同じIPアドレスから使用すると制限が共有される可能性があります。

---

## Gemini API 有料プラン（Pay-as-you-go）への移行

### 重要な説明

**有料プラン ≠ より高性能なモデル**

有料プランにすると得られるのは:
- ✅ **RPM（リクエスト数）制限の大幅緩和**: 15回/分 → 1,000回/分
- ✅ **TPM（トークン数）制限の緩和**: 100万/分 → 400万/分
- ❌ **モデルの性能向上ではない**

**モデルの違い:**

| モデル | 特徴 | 速度 | 精度 | 料金 |
|--------|------|------|------|------|
| **gemini-2.5-flash** (現在使用中) | 高速・軽量 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | 無料枠: 15RPM<br>有料: $0.075/1M入力 |
| **gemini-2.5-pro** | 高精度・重い | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 無料枠: 2RPM<br>有料: $1.25/1M入力 |

**推奨:**
- **このアプリでは `gemini-2.5-flash` で十分な精度**が出ています
- モデルは変更せず、**有料プランに移行するだけで制限が解除**されます
- Pro版は約17倍高額なので、必要性がない限り不要

### 料金体系（Pay-as-you-go）

#### gemini-2.5-flash（推奨）
- **無料版**: 15回/分、100万トークン/分
- **有料版**: 1,000回/分、400万トークン/分
- **料金**: $0.075/100万入力トークン、$0.30/100万出力トークン

**実際のコスト例:**
- 日本酒画像1枚解析 ≒ 5万トークン入力 = **約$0.004 (約0.6円)**
- 100枚解析しても **約60円**

#### gemini-2.5-pro（高精度が必要な場合のみ）
- **無料版**: 2回/分、3.2万トークン/分
- **有料版**: 1,000回/分、400万トークン/分
- **料金**: $1.25/100万入力トークン（flashの約17倍）

### 有料版への移行手順

#### 1. Google AI Studioで課金設定
```
1. https://aistudio.google.com/ にアクセス
2. 左メニュー「Billing」をクリック
3. 「Enable Pay-as-you-go」を選択
4. クレジットカード情報を登録
5. 利用上限を設定（例: 月$10まで）
```

#### 2. アプリのモデル設定（変更不要）
`lib/services/gemini_service.dart` の18行目:

```dart
// 現在の設定（推奨: このまま）
static const String _modelName = 'gemini-2.5-flash';

// より高精度が必要な場合のみ（17倍高額）
// static const String _modelName = 'gemini-2.5-pro';
```

**注意:** モデルを変更しなくても、課金設定するだけで**制限が大幅に緩和**されます

#### 3. アプリを再ビルド（モデル変更時のみ）
```bash
# モデルを変更した場合のみ必要
flutter clean
flutter build apk --release
```

**注意:** 課金設定だけなら**再ビルド不要**です。同じAPKで制限が緩和されます。

---

## 現在の制限対策（無料版）

アプリに実装済みの対策:

### 1. 自動レート制限保護
- **5秒間隔の強制**: 連続解析時に自動的に待機
- トークン消費量のログ出力（デバッグ時）

### 2. 画像サイズの最適化
- カメラ解像度: **high (1080p) → medium (720p)**
- ファイルサイズ約50%削減
- 認識精度は維持

### 3. ユーザー向け情報表示
- ホーム画面に「ℹ️」アイコン追加
- API制限の詳細説明
- 推奨事項の表示

### 4. 詳細なエラーメッセージ
```
AI使用制限に達しました。
無料版は1分間に15回までの制限があります。
1〜2分後に再度お試しください。
```

---

## おすすめの運用方法

### 無料版で運用する場合
- ✅ **5秒以上間隔を空けて解析**（自動化済み）
- ✅ 同じ画像を再解析しない
- ✅ エラーが出たら1-2分待つ
- ✅ 1日あたり100-200枚程度まで

### 有料版に移行する場合（推奨）
- ✅ 月数百円で制限をほぼ気にせず使える
- ✅ RPM 1,000回/分 → 実質無制限
- ✅ ビジネス利用に最適

---

## トラブルシューティング

### Q: 新しいAPIキーでもすぐエラーが出る
A: 同じIPアドレスから利用している可能性があります。モバイルデータ通信に切り替えてテストしてください。

### Q: Google One Proで無制限にならないの？
A: Google One ProはGmail/Docs用の特典です。API料金は別途発生します。

### Q: 有料版にしたらいくらかかる？
A: 1日10枚程度なら月100円以下、100枚/日でも月700円程度です。

### Q: APIキーが流出したらどうなる？
A: Google AI Studioで即座に無効化し、新しいキーを発行してください。

---

## 参考リンク

- [Google AI Studio](https://aistudio.google.com/)
- [Gemini API料金表](https://ai.google.dev/pricing)
- [API使用量の確認](https://aistudio.google.com/quota)

---

**最終更新:** 2025-12-31
