Google AI (Gemini API) 連携

Google AI Studio と連携すると、AI スタッフの思考エンジンとして Gemini API（gemini-2.5-pro / gemini-2.5-flash 等）を直接使えるようになります。

API 利用料は Google AI からあなた（テナントオーナー）へ直接請求 されます。LinkPoint には請求が発生しません（BYOC）。

できること

「葉山さんを Gemini 2.5 Pro で運用、ESG 関連の長文を高速処理する」
「Basic プランで標準の Gemini CLI 1,000 req/日を超えて使い続ける」
「コスト最優先で gemini-2.5-flash を割り当て、軽量な業務に振る」

連携手順

1. Google AI Studio で API キーを発行

https://aistudio.google.com/app/apikey にアクセス
「Create API key」 をクリック
プロジェクトを選択（または新規作成）→ Create
表示されたキー（AIzaSy...）を すぐにコピー

2. 課金の設定（無料枠を超える場合）

Google AI Studio は 無料枠 が手厚いですが、超過分には Google Cloud プロジェクトの請求が必要です:

無料枠（Free tier）: 1 分 15 req / 1 日 1,500 req（Flash 系モデル）
課金有効化: https://console.cloud.google.com/billing でクレジットカード登録
詳細: https://ai.google.dev/pricing

3. LinkPoint に登録

LinkPoint Chat にログイン
右上のアバター → プロフィール → 外部連携 タブ
「AI モデル API キー（BYOC）」 セクションへスクロール
Google AI カードを開く
API Key 欄に AIzaSy... を貼り付け → 「保存」
「接続テスト」 で ✅ 接続成功 models=N sample=models/gemini-... が表示されれば完了

4. スタッフのモデルを切り替え

スタッフ管理 → 任意のスタッフを編集
思考LLM ドロップダウン → Gemini API 🔑 を選択
Model ドロップダウンで gemini-2.5-pro / gemini-2.5-flash 等を指定
保存

料金プラン目安

Google AI Studio API は従量課金（2026年4月時点）:

モデル	入力 (1M tokens)	出力 (1M tokens)	用途
Gemini 2.5 Pro	$1.25	$10	高品質、長文・推論
Gemini 2.5 Flash	$0.30	$2.50	バランス型、高速
Gemini 2.0 Flash	$0.075	$0.30	超軽量・低コスト

目安: 1 メッセージ (日本語 300〜500 文字、出力同量) で Flash なら $0.001 未満、Pro なら $0.003 程度。Anthropic / OpenAI より圧倒的に安価。

最新料金は https://ai.google.dev/pricing をご確認ください。

Gemini CLI vs Gemini API 使い分け

観点	Gemini CLI（標準）	Gemini API（BYOC）
料金	無料（Code Assist 無料枠）	従量課金（テナント負担）
制限	1分60req / 1日1,000req（全テナント共有）	個別 API キー、独立枠
設定不要さ	LinkPoint 側設定済み	自分で API キー発行
最新モデル追従	やや遅い（CLI 経由）	即時
バッチ処理	制限低い	自由

おすすめ: 通常運用は Gemini CLI、上限到達 or 大量バッチ時のフォールバックに Gemini API。

トラブルシューティング

`API_KEY_INVALID` エラー

キー文字列に空白が混ざってないか確認
Google AI Studio で revoke されていないか確認

`RESOURCE_EXHAUSTED` エラー（429）

無料枠超過 → Google Cloud Billing でクレジット有効化
レート制限超過 → 短時間集中送信を回避、gemini-2.5-flash 等の軽量モデルに切替

「接続テスト」は成功するが応答が遅い

gemini-2.5-pro はレスポンスに数秒かかります
速度優先なら gemini-2.5-flash、超高速なら gemini-2.0-flash に切替

セキュリティ

per-tenant 分離

API キーは chat_user_integrations/{your-tenant-uid}.google_ai.secrets.apiKey に AES-256-GCM 暗号化で保存。別テナントから構造的にアクセス不可。

監査ログ

Gemini API への呼び出しは LinkPoint 側でログ記録 + Google Cloud Logging（プロジェクト課金有効時）にも残ります。

連携解除

プロフィール → 外部連携 → Google AI → 削除で LinkPoint 側のキー削除。Google 側で revoke する場合は https://aistudio.google.com/app/apikey で「Delete API key」。