178 lines
5.8 KiB
Markdown
178 lines
5.8 KiB
Markdown
# 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
|