# 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
有料: $0.075/1M入力 |
| **gemini-2.5-pro** | 高精度・重い | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 無料枠: 2RPM
有料: $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