mai
/
ponshu-room-lite
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity
ponshu-room-lite/GEMINI_PRO_SETUP.md

5.8 KiB
Raw Blame History

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 にアクセス
  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行目:

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

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

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

3. アプリを再ビルド（モデル変更時のみ）

# モデルを変更した場合のみ必要
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で即座に無効化し、新しいキーを発行してください。

参考リンク

最終更新: 2025-12-31