TAG

gemini-api

300 記事

Gemini APIのtemperature・top-p・top-kを感覚ではなく数値で使い分けるための実験記録。要約・創作・分類・コード生成の4タスクで計測した最適値と、チューニングの手順を共有します。

Gemini API を Cloudflare Workers や Vercel Edge Runtime で使うと突然 'subrequest limit exceeded' で止まる問題の原因と、私が運用しているサイト群で実際に効いた対処パターンをまとめます。

Gemini API を本番運用するなら避けて通れない Prompt Injection 攻撃に対し、入力サニタイズ・指示強化・構造化出力・モデレーター LLM の4層防御を動くコードで設計する実戦ガイドです。

Gemini API の本番運用で発生する 429・503・タイムアウト障害を乗り切るための耐障害性設計を実装レベルで解説します。Circuit Breaker、Bulkhead、フォールバックモデル切替、Graceful Degradation までコード付きで網羅します。

Gemini API で突然返ってくる INVALID_ARGUMENT(400) エラーは原因の幅がとても広く、エラーメッセージだけでは判別しにくいのが実情です。代表的な 7 つの原因パターンを、実際のレスポンスとコード修正例付きで解説します。

Gemini API で英語出力を指示しても日本語が混じる、あるいは逆に英訳が勝手に要約されるという問題の実装パターンでの解決方法を、System Instructions・Few-shot・response_schema を組み合わせて解説します。

Gemini API キーの漏洩は個人開発者にとって現実的なリスクです。Git への誤コミット、クライアントサイド露出、課金上限の未設定など、よくある穴を塞ぐための実務チェックリストを5項目にまとめました。

プロンプトを1行直しただけで本番出力が別物になった経験はありませんか。本記事では Gemini API のプロンプトを Pytest でテストし、スナップショットと LLM-as-Judge を組み合わせて回帰を自動検出する実装パターンを、個人開発者の実運用目線で解説します。

ローカルでは動くのに Vercel や Cloudflare Workers、AWS Lambda にデプロイした途端に Gemini API が失敗する。その原因の多くは環境変数・ランタイム・タイムアウトの3つに集約できます。本記事では実例ベースで切り分け手順を解説します。

Gemini 2.5 Pro の長大なコンテキストに 500 ページ級の PDF を丸ごと投げ込むと、要約は動くのに品質が後半で崩れます。章単位でチャンク → 並列要約 → 全体再結合というパターンで安定させる実装を、私自身のつまずきと合わせて整理します。

MLX 版 Gemma 4 をローカル推論のバックボーンに据えるための、量子化ビット選定・コンテキスト戦略・Reasoning 機能欠落の補い方を実装コード込みで解説します。Gemini API との役割分担も扱います。

Gemini 2.5 / 3 の思考サマリー（thought summaries）を Next.js の UI に取り込み、AI の判断根拠をユーザーに伝える実装を解説します。SDK 設定・SSE・React の折り畳み表示・UX 設計・観測までを通しで扱う本番向けガイドです。