すべての記事
Gemini API のセーフティフィルタが正当な応答を黙って落とすとき — 全切りせず誤検知だけを救う運用メモ
本番のGemini APIで正当なプロンプトがSAFETYでブロックされる誤検知を、全カテゴリ無効化に逃げずに扱う運用メモ。入力ブロックと出力ブロックの切り分け、誤検知率の計装、カテゴリ別の段階的リカバリまでを実装で整理します。
Gemini API の月額上限に当てた瞬間、有料ユーザーまで止まる — Project Spend Caps の影響範囲をプロジェクト分割で閉じ込める
Project Spend Caps はプロジェクト全体を一度に止めます。無料ユーザーの暴走が有料ユーザーを巻き込まないよう、上限の影響範囲をティア別プロジェクトで分離し、約10分の遅延を埋めるソフト予算ゲートを実装する設計メモです。
Gemini 3.1 Flash Image で日本語テキスト入り画像を安定生成する ― OCR検証ゲート付きパイプライン
プレビュー停止後の GA 版 gemini-3.1-flash-image で、画像内の日本語テキストが崩れる問題に向き合います。生成→OCR検証→再生成／合成フォールバックの二段構えを、動くコードと無人運用のリトライ設計まで含めて記録しました。
Gemini 3.1 Flash TTS プレビューで記事を音声化する — 長文を割って繋ぐナレーション生成とコストの実際
本日プレビュー提供が始まった Gemini 3.1 Flash TTS で、書いた記事を一人語りの音声に変換するパイプラインを組みます。長文の分割と無音の継ぎ目、声を揺らさないプロンプト制御、1記事あたりの実コスト計算まで、個人開発の現場目線でまとめます。
Gemini API × TypeScript 型安全AIアプリケーション設計ガイド — Zodスキーマ・Structured Output・ストリーミングの統合アーキテクチャ
Gemini APIとTypeScriptで型安全なAIアプリケーションを構築する方法を解説。Zodバリデーション、Structured Output、ストリーミング、エラーハンドリングを統合した本番アーキテクチャを実装します。
Gemini API の構造化出力が本番で静かにスキーマから外れるとき — 検証と再試行を計測する運用メモ
response_schema を指定しても、Gemini の構造化出力は本番で時折スキーマからずれます。失敗を握りつぶさず計測し、finish_reason で原因を切り分け、エラーを差し戻して再試行する。実運用で安定させた検証パイプラインのメモです。
プレビュー画像モデル停止の朝に学んだこと — Gemini 画像モデル GA 移行と廃止に強いパイプライン設計
gemini-3.1-flash-image-preview と gemini-3-pro-image-preview の停止を機に、GA 版への移行手順と、廃止日に振り回されない画像生成パイプラインの設計をコード付きで整理します。動画から画像を生成するサムネイル自動化も扱います。
Gemini API × Android Jetpack Compose 完全統合ガイド — Kotlin ネイティブ AI アプリの本番設計パターン
Kotlin + Jetpack Compose でネイティブ Android AI アプリを構築する完全ガイド。Google AI SDK for Android の導入から ViewModel 設計、Multimodal 対応、Room DB 履歴管理、セキュリティ戦略まで本番レベルで解説します。
ローカルGemma 4を日々の作業に組み込む — Ollama APIと応答速度の実践メモ
対話で動かせるようになったローカルGemma 4を、実際の作業に組み込むところまで。OllamaのローカルAPIをスクリプトから叩く方法、応答速度を体感で上げる工夫、クラウドのGemini APIへ自動でフォールバックする二段構えの実装まで、コード込みで解説します。
File Searchの回答に「何ページの、どの図か」まで添える ― 視覚引用メタデータで出典を検証可能にする
File Search の grounding metadata に media_id と page_numbers が加わり、回答のどの一文がどのページ・どの図に基づくのかを辿れるようになりました。PDFと画像を混ぜた参照データで、検証可能な引用UIを組み立てるまでを実装で整理します。
Gemini API × GraphQL インテリジェントデータレイヤー構築ガイド
GraphQL スキーマに Gemini API を統合し、AI 駆動のリゾルバー、セマンティックキャッシュ、型安全な設計を実装するための包括的ガイド。本番レベルのインテリジェントデータレイヤーを構築します。
Gemini API × Cloudflare D1：エッジSQLiteでAIバックエンドを月$10以下に収めた実装メモ
Cloudflare Workers + D1（エッジSQLite）とGemini APIで、コールドスタートゼロ・グローバル低レイテンシー・月$10以下のAIバックエンドを構築する実装メモ。スキーマ設計からレート制限、ストリーミング後の遅延隠蔽、本番運用までを実体験ベースでまとめました。