ARTICLES

すべての記事

HTTP 200 なのに応答が途中で切れ、finish_reason に RECITATION が入っている——Gemini API の著作権ブロックが発火する条件と回避策を解説します。変換タスクへのプロンプト書き換え、temperature 調整、自動リトライの実装パターンを扱います。

Gmail・Google CalendarをまたぐパーソナルAI秘書をGemini APIで組む設計。OAuth2スコープ設計・Function Callingのオーケストレーション・書き込み系ツールの承認ゲート・90日運用の実測コストまでコード付きで扱います。

Gemini 3.1 Flash TTS の200種類以上の感情タグ・多話者機能を活用し、AI ポッドキャストを自動生成する本番対応パイプラインを構築します。コスト計算から収益化設計まで、個人開発者が月10万円のコンテンツサービスを立ち上げるための全工程を解説します。

Gemini API を個人アプリに本番導入した時に直面する設計判断を、私自身の運用記録から 7 つに絞ってまとめました。コストとレイテンシのトレードオフ、エラー時のフォールバック設計、品質モニタリングまで、教科書には載っていない実戦的な判断軸を共有します。

Gemini API のマルチモーダル機能を個人開発の収益化へ直結させるロードマップです。Gemini × Firebase × Stripe のアーキテクチャ、動画・音声解析の課金パターン、無料から有料への導線設計、サブスクと単発購入のハイブリッドまで実装コードで示します。

Gemini API は無料枠が非常に手厚い反面、その境界線が複雑です。Free Tier の制限と Paid Tier への切り替えタイミング、コンテキストキャッシュの活用、マルチモーダル課金の落とし穴を、個人開発者の財布感覚で整理しました。

Gemini Embedding と Cloudflare Vectorize を組み合わせ、Workers ランタイム上で完結する低レイテンシ・低コストの本番エッジ RAG を実装します。サブリクエスト制限の回避、リトライ、フォールバック、コスト試算まで踏み込みます。

Gemini API に PDF を送ったのに本文が返ってこない症状を、フローチャートで切り分けて解決します。スキャン画像 PDF、20MB のインライン上限、1,000ページ制限、MIME タイプの不一致、表組みや数式の崩れという5つの原因別に対処を示します。

ベクトル検索だけでは答えられない関係性を辿る質問のために、Gemini で知識グラフを抽出しベクトル検索と組み合わせる GraphRAG を構築します。グラフ抽出、並列構築、質問の分岐、コンテキスト統合、本番で詰まる5つの落とし穴まで動くコードで解説します。

Gemini API の構造化出力を Zod スキーマで検証する実装パターンを解説します。as による型キャストの落とし穴、JSON Schema への変換、検証失敗時のリトライ設計までコード付きで紹介します。

AI Studio の API キーで動いていた Gemini のコードを Vertex AI に移行した作業ログです。SDK 初期化の書き換え、認証エラーで丸一日費やした環境変数、構造化出力で気づいたレスポンス形式の差異など、実際に手を動かして分かった差分を残しました。

Gemini API を使った RAG に「信頼できる出典」を組み込むための実装パターンを、構造化出力・検証アルゴリズム・UI 表示まで通しで解説します。ハルシネーションを定量的に検出する仕組みも含めて、本番投入できる形で紹介します。